diff --git a/README.md b/README.md
new file mode 100644
index 0000000..fe04dc4
--- /dev/null
+++ b/README.md
@@ -0,0 +1,48 @@
+# pretalx musicrate plugin
+
+This is a [pretalx] plugin for rating music.
+
+## Development setup
+
+1. Make sure that you have a working [pretalx development setup].
+
+2. Clone this repository, e.g. to `local/pretalx-musicrate`.
+
+3. Activate the virtual environment you use for pretalx development.
+
+4. Run `pip install -e .` within this directory to register this application with pretalx's plugin registry.
+
+5. Run `make` within this directory to compile translations.
+
+6. Restart your local pretalx server. This plugin should show up in the plugin list shown on startup in the console.
+   You can now use the plugin from this repository for your events by enabling it in the 'plugins' tab in the settings.
+
+This plugin has CI set up to enforce a few code style rules. To check locally, you need these packages installed:
+
+```
+pip install flake8 flake8-bugbear isort black
+```
+
+To check your plugin for rule violations, run:
+
+```
+black --check .
+isort -c .
+flake8 .
+```
+
+You can auto-fix some of these issues by running:
+
+```
+isort .
+black .
+```
+
+## License
+
+Copyright 2023 Luca Schmid
+
+Released under the terms of the Apache License 2.0
+
+[pretalx]: https://github.com/pretalx/pretalx
+[pretalx development setup]: https://docs.pretalx.org/en/latest/developer/setup.html
diff --git a/README.rst b/README.rst
deleted file mode 100644
index 28bf90d..0000000
--- a/README.rst
+++ /dev/null
@@ -1,48 +0,0 @@
-pretalx musicrate plugin
-==========================
-
-This is a plugin for `pretalx`_.
-pretalx plugin for rating music
-
-Development setup
------------------
-
-1. Make sure that you have a working `pretalx development setup`_.
-
-2. Clone this repository, eg to ``local/pretalx-musicrate``.
-
-3. Activate the virtual environment you use for pretalx development.
-
-4. Run ``pip install -e .`` within this directory to register this application with pretalx's plugin registry.
-
-5. Run ``make`` within this directory to compile translations.
-
-6. Restart your local pretalx server. This plugin should show up in the plugin list shown on startup in the console.
-   You can now use the plugin from this repository for your events by enabling it in the 'plugins' tab in the settings.
-
-This plugin has CI set up to enforce a few code style rules. To check locally, you need these packages installed::
-
-    pip install flake8 flake8-bugbear isort black
-
-To check your plugin for rule violations, run::
-
-    black --check .
-    isort -c .
-    flake8 .
-
-You can auto-fix some of these issues by running::
-
-    isort .
-    black .
-
-
-License
--------
-
-Copyright 2023 Luca
-
-Released under the terms of the Apache License 2.0
-
-
-.. _pretalx: https://github.com/pretalx/pretalx
-.. _pretalx development setup: https://docs.pretalx.org/en/latest/developer/setup.html