diff --git a/README b/README
deleted file mode 100644
index b39323d0af3b63af655eaa5810f3d61231427730..0000000000000000000000000000000000000000
--- a/README
+++ /dev/null
@@ -1,59 +0,0 @@
-To run locally (for testing purposes):
-
-- Install proxychains, configure it for Tor
-
-- Pull in the dependencies:
-$ proxychains ./setup_venv.sh
-(you can also pull them non-anon by leaving out proxychains)
-
-- Compile translations (if you want to see them):
-$ ./compile-messages.sh
-
-- Start the webserver:
-$ ./runserver.py
-
-- Open the site at http://localhost:5000/
-
-# MIRROR OPERATORS #
-
-If you want to mirror the I2P website, thanks! Here is a checklist:
-
-- Do not edit any of the files in i2p2www/ 
-  - In particular, do not change the CANONICAL_DOMAIN variable in
-    i2p2www/__init__.py, it needs to point to the official site for SEO.
-- If you need to edit variables in etc/update.vars, copy the file to
-  etc/update.vars.custom and edit appropriately. The only variable you
-  may need to edit is MTNURL in etc/update.vars (if your Monotone client
-  tunnel is listening on a different port).
-- If you want to enable caching, copy i2p2www/settings.py.sample to
-  i2p2www/settings.py and edit appropriately.
-- Add ./site-updater.sh to your crontab. This will keep the site updated,
-  recompile the translations when necessary, and touch a file in /tmp/
-  (look in etc/update.vars for the filename, your webserver should restart
-  WSGI when the timestamp of this file changes).
-
-# Updating translations #
-
-- Pull new and updated translations from Transifex:
-$ tx pull -a
-
-- Correctly format the translations:
-$ ./update-existing-po.sh
-
-- Check in the updated translations:
-$ mtn ci i2p2www/translations/ -m "Updated translations"
-
-- Check in any new translations:
-$ mtn add -R i2p2www/translations/ && mtn ci i2p2www/translations/ -m "New translations"
-
-- Update the POT files with any changes to the website text:
-$ ./extract-messages.sh
-
-- Update the translations with any changes to the website text:
-$ ./update-existing-po.sh
-
-- Check in any changes to the website text:
-$ mtn ci pots/ i2p2www/translations/ -m "Updated translation strings"
-
-- Push website text changes to Transifex:
-$ tx push -s
diff --git a/README.md b/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..7e8d22563b5463189aa1ef2884e9a169d531d49e
--- /dev/null
+++ b/README.md
@@ -0,0 +1,95 @@
+# I2P website
+
+To run locally (for testing purposes):
+
+- Install proxychains, configure it for Tor
+
+- Pull in the dependencies:
+
+    ```
+    $ proxychains ./setup_venv.sh
+    ```
+
+    (you can also pull them non-anon by leaving out proxychains)
+
+- Compile translations (if you want to see them):
+
+    ```
+    $ ./compile-messages.sh
+    ```
+
+- Start the webserver:
+
+    ```
+    $ ./runserver.py
+    ```
+
+- Open the site at http://localhost:5000/
+
+## Running a mirror
+
+If you want to mirror the I2P website, thanks! Here is a checklist:
+
+- Do not edit any of the files in `i2p2www/` 
+  - In particular, do not change the `CANONICAL_DOMAIN` variable in
+    `i2p2www/__init__.py`, it needs to point to the official site for SEO.
+- If you need to edit variables in `etc/update.vars`, copy the file to
+  `etc/update.vars.custom` and edit appropriately. The only variable you
+  may need to edit is `MTNURL` in `etc/update.vars` (if your Monotone client
+  tunnel is listening on a different port).
+- If you want to enable caching, copy `i2p2www/settings.py.sample` to
+  `i2p2www/settings.py` and edit appropriately.
+- Add `./site-updater.sh` to your crontab. This will keep the site updated,
+  recompile the translations when necessary, and touch a file in `/tmp/`
+  (look in `etc/update.vars` for the filename, your webserver should restart
+  WSGI when the timestamp of this file changes).
+
+## Updating translations
+
+1. Pull new and updated translations from Transifex:
+
+    ```
+    $ tx pull -a
+    ```
+
+2. Correctly format the translations:
+
+    ```
+    $ ./update-existing-po.sh
+    ```
+
+3. Check in the updated translations:
+
+    ```
+    $ mtn ci i2p2www/translations/ -m "Updated translations"
+    ```
+
+4. Check in any new translations:
+
+    ```
+    $ mtn add -R i2p2www/translations/ && mtn ci i2p2www/translations/ -m "New translations"
+    ```
+
+5. Update the POT files with any changes to the website text:
+
+    ```
+    $ ./extract-messages.sh
+    ```
+
+6. Update the translations with any changes to the website text:
+
+    ```
+    $ ./update-existing-po.sh
+    ```
+
+7. Check in any changes to the website text:
+
+    ```
+    $ mtn ci pots/ i2p2www/translations/ -m "Updated translation strings"
+    ```
+
+8. Push website text changes to Transifex:
+
+    ```
+    $ tx push -s
+    ```