diff --git a/README.md b/README.md
new file mode 100644
index 00000000..62ff4173
--- /dev/null
+++ b/README.md
@@ -0,0 +1,54 @@
+data.coop-website
+=================
+
+[](https://drone.data.coop/data.coop/website)
+
+This is a [Hugo](https://gohugo.io/) project.
+
+Running locally
+---------------
+
+Go to [Hugo Github release](https://github.com/gohugoio/hugo/releases)
+and fetch the latest package for **hugo\_extended** for your system.
+
+We want to align with the latest version always. If it doesn't work,
+file an issue!
+
+Example recipe
+
+``` {.sourceCode .bash}
+# Fetch .deb from Github
+wget https://github.com/gohugoio/hugo/releases/download/v0.69.2/hugo_extended_0.69.2_Linux-64bit.deb -O hugo_extended.deb
+
+# Install package
+sudo dpkg -i hugo_extended.deb
+
+# Clone repo
+git clone https://git.data.coop/data.coop/website.git data.coop-website
+
+# Go to website
+cd data.coop-website
+
+# Run development server
+hugo server
+```
+
+Deploying the site
+------------------
+
+Simply pushing to `master` in our main repo at
+ will trigger a
+build-and-deploy of the website.
+
+Multilingual notes
+------------------
+
+Our website is made multi-lingual using the following 3 structures:
+
+1. The folder `i18n/` contains translations of strings used in the
+ theme.
+2. Each content article and news text has a language version such
+ `content/.en.md`
+3. The `config.yaml` contains settings specific to each language, such
+ as navigation.
+
diff --git a/README.rst b/README.rst
deleted file mode 100644
index b984fce9..00000000
--- a/README.rst
+++ /dev/null
@@ -1,51 +0,0 @@
-data.coop-website
-=================
-
-.. image:: https://drone.data.coop/api/badges/data.coop/website/status.svg
- :alt: Build Status
- :target: https://drone.data.coop/data.coop/website
-
-This is a `Hugo `__ project.
-
-Running locally
----------------
-
-Go to `Hugo Github release `__ and fetch the latest package for **hugo_extended** for your system.
-
-We want to align with the latest version always. If it doesn't work, file an issue!
-
-Example recipe
-
-.. code-block:: bash
-
- # Fetch .deb from Github
- wget https://github.com/gohugoio/hugo/releases/download/v0.69.2/hugo_extended_0.69.2_Linux-64bit.deb -O hugo_extended.deb
-
- # Install package
- sudo dpkg -i hugo_extended.deb
-
- # Clone repo
- git clone https://git.data.coop/data.coop/website.git data.coop-website
-
- # Go to website
- cd data.coop-website
-
- # Run development server
- hugo server
-
-
-Deploying the site
-------------------
-
-Simply pushing to ``master`` in our main repo at https://git.data.coop/data.coop/website/ will trigger a build-and-deploy of the website.
-
-
-Multilingual notes
-------------------
-
-Our website is made multi-lingual using the following 3 structures:
-
-#. The folder ``i18n/`` contains translations of strings used in the theme.
-#. Each content article and news text has a language version such ``content/.en.md``
-#. The ``config.yaml`` contains settings specific to each language, such as navigation.
-