diff --git a/README b/README
deleted file mode 100644
index f89208e..0000000
--- a/README
+++ /dev/null
@@ -1,48 +0,0 @@
- ===============
- FetchRSS
- ===============
-
- This project is an implementation of a simple HTML RSS feed reader
- and aggregator with JavaScript and Python.
-
-
- Installation
-------------
-
- Clone the project. On the web server, create a working directory
- called 'fetchrss'. Add the following files to it:
-
- * feed-loader.js
- * rss_agg.py
- * rss.sh
-
- Make 'rss_agg.py' and 'rss.sh' executable:
-
- chmod 750 rss_agg.py rss.sh
-
- Call 'feed-loader.js' from the HTML page where the RSS feeds will
- be displayed:
-
- <div id="rss-feed-box"></div>
- <script src="/fetchrss/feed-loader.js"></script>
-
- Add CRON jobs to run 'rss_agg.py' and 'rss.sh' on a schedule:
-
- ```
- 0 */6 * * * cd /path/to/fetchrss && bash rss.sh >/dev/null 2>&1
- 3 */6 * * * cd /path/to/fetchrss && python3 rss_agg.py >/dev/null 2>&1
- ```
-
-
- See also
---------
-
- The blog post: https://cybrkyd.com/post/fetchrss-version-2/
-
-
- Licence
--------
-
- This project is made available under a GPL3 licence -- see COPYING
- for the full text.
-
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..c2793e8
--- /dev/null
+++ b/README.md
@@ -0,0 +1,43 @@
+ # FetchRSS
+
+ This project is an implementation of a simple HTML RSS feed reader and aggregator with JavaScript and Python.
+
+ ## Installation
+
+ Clone the project.
+
+ 1. On the web server, create a working directory called 'fetchrss'. Add the following files to it:
+ ```
+ feed-loader.js
+ rss_agg.py
+ rss.sh
+ ```
+
+ 2. Make `rss_agg.py` and `rss.sh` executable:
+
+ ```
+ chmod 750 rss_agg.py rss.sh
+ ```
+
+ 3. Call `feed-loader.js` from the HTML page where the RSS feeds will be displayed:
+
+ ```
+ <div id="rss-feed-box"></div>
+ <script src="/fetchrss/feed-loader.js"></script>
+ ```
+
+ 4. Add CRON jobs to run `rss_agg.py` and `rss.sh` on a schedule:
+
+ ```
+ 0 */6 * * * cd /path/to/fetchrss && bash rss.sh >/dev/null 2>&1
+ 3 */6 * * * cd /path/to/fetchrss && python3 rss_agg.py >/dev/null 2>&1
+ ```
+
+ ## See also
+
+ The blog post: [https://cybrkyd.com/post/fetchrss-version-2](https://cybrkyd.com/post/fetchrss-version-2)
+
+ ## Licence
+
+ This project is made available under a GPL3 licence -- see COPYING for the full text.
+