diff --git a/web/README b/web/README
deleted file mode 100644
index c8e603791..000000000
--- a/web/README
+++ /dev/null
@@ -1,6 +0,0 @@
-
-Starting up
-
-- npm install
-- gulp
-- run mitmweb and open http://localhost:8081/
diff --git a/web/README.md b/web/README.md
new file mode 100644
index 000000000..c43d09f02
--- /dev/null
+++ b/web/README.md
@@ -0,0 +1,6 @@
+# Quick Start
+
+
+- Run `yarn` to install dependencies
+- Run `gulp` to start live-compilation.
+- Run `mitmweb` and open http://localhost:8081/