diff --git a/README.md b/README.md
index 590991e3c6..ef767a0107 100644
--- a/README.md
+++ b/README.md
@@ -35,8 +35,11 @@ Navigate to `http://localhost:4200/`. The app will automatically reload if you c
 ```
 $ npm install
 $ npm run start
+$ npm run markdown:watch
 ```
 
+All pages are written in the [markdown](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet) and located in the `content` directory. Run `npm run markdown:watch` to compile them to HTML files on file change.
+
 ## Build
 
 Run `ng build` to build the project. The build artifacts will be stored in the `dist/` directory. Use the `-prod` flag for a production build.