diff --git a/MANIFEST.in b/MANIFEST.in
index 78ebbaf63e6dbd5f1f26a23850f0179bc1161e49..52c9c04b7852c8424d233786d8f2e8a82cc8aa22 100644
--- a/MANIFEST.in
+++ b/MANIFEST.in
@@ -1,3 +1,3 @@
-include README.rst
+include LICENSE README.md
 recursive-include doc *.rst *.png *.ico *.txt
 recursive-include bob *.csv *.json *.pgm
diff --git a/README.md b/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..2fff19366c4ab46450e6c02ada43812ff608129f
--- /dev/null
+++ b/README.md
@@ -0,0 +1,33 @@
+[![badge doc](https://img.shields.io/badge/docs-latest-orange.svg)](https://www.idiap.ch/software/bob/docs/bob/bob.pipelines/master/sphinx/index.html)
+[![badge pipeline](https://gitlab.idiap.ch/bob/bob.pipelines/badges/master/pipeline.svg)](https://gitlab.idiap.ch/bob/bob.pipelines/commits/master)
+[![badge coverage](https://gitlab.idiap.ch/bob/bob.pipelines/badges/master/coverage.svg)](https://www.idiap.ch/software/bob/docs/bob/bob.pipelines/master/coverage)
+[![badge gitlab](https://img.shields.io/badge/gitlab-project-0000c0.svg)](https://gitlab.idiap.ch/bob/bob.pipelines)
+
+# Tools to build robust and extensible pipelines
+
+This package is part of the signal-processing and machine learning toolbox
+[Bob](https://www.idiap.ch/software/bob).
+
+The goal is to provide more flexible pipeline mechanisms for
+[bob.bio.base](http://gitlab.idiap.ch/bob/bob.bio.base) and
+[bob.pad.base](http://gitlab.idiap.ch/bob/bob.pad.base).
+
+It is based on the
+[scikit-learn pipeline](https://scikit-learn.org/stable/modules/compose.html)
+and adds a layer to route data and metadata through the pipeline (which is not
+supported by scikit-learn yet).
+
+## Installation
+
+Complete bob's
+[installation instructions](https://www.idiap.ch/software/bob/install). Then,
+to install this package, run:
+
+``` sh
+conda install bob.pipelines
+```
+
+## Contact
+
+For questions or reporting issues to this software package, contact our
+development [mailing list](https://www.idiap.ch/software/bob/discuss).
diff --git a/README.rst b/README.rst
deleted file mode 100644
index 2a0a0c977948ce5e6ab5d21728213b9a8d42a3f1..0000000000000000000000000000000000000000
--- a/README.rst
+++ /dev/null
@@ -1,41 +0,0 @@
-.. -*- coding: utf-8 -*-
-
-.. image:: https://img.shields.io/badge/docs-latest-orange.svg
-   :target: https://www.idiap.ch/software/bob/docs/bob/bob.pipelines/master/sphinx/index.html
-.. image:: https://gitlab.idiap.ch/bob/bob.pipelines/badges/master/pipeline.svg
-   :target: https://gitlab.idiap.ch/bob/bob.pipelines/commits/master
-.. image:: https://gitlab.idiap.ch/bob/bob.pipelines/badges/master/coverage.svg
-   :target: https://www.idiap.ch/software/bob/docs/bob/bob.pipelines/master/coverage
-.. image:: https://img.shields.io/badge/gitlab-project-0000c0.svg
-   :target: https://gitlab.idiap.ch/bob/bob.pipelines
-
-
-===========================================================================
- Tools to build robust and extensible pipelines
-===========================================================================
-
-This package is part of the signal-processing and machine learning toolbox Bob_.
-
-This is **STILL EXPERIMENTAL** and the goal is to provide more flexible pipeline mechanism for `bob.bio.base <http://gitlab.idiap.ch/bob/bob.bio.base>`_ and `bob.pad.base <http://gitlab.idiap.ch/bob/bob.pad.base>`_.
-
-
-Installation
-------------
-
-Complete bob's `installation`_ instructions. Then, to install this
-package, run::
-
-  $ conda install bob.pipelines
-
-
-Contact
--------
-
-For questions or reporting issues to this software package, contact our
-development `mailing list`_.
-
-
-.. Place your references here:
-.. _bob: https://www.idiap.ch/software/bob
-.. _installation: https://www.idiap.ch/software/bob/install
-.. _mailing list: https://www.idiap.ch/software/bob/discuss
diff --git a/pyproject.toml b/pyproject.toml
index 07adc9d28da6ef2ef8fea10e338933fc0b8ac3f8..256a9b040fe3e10b81b75e731fa7ca45524d7d90 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -68,7 +68,7 @@
     package-dir = {"" = "src"}
 
 [tool.setuptools.dynamic]
-    readme = {file = "README.rst"}
+    readme = {file = "README.md", content-type = "text/markdown"}
 
 [project.entry-points."dask.client"]
     local-parallel  = "bob.pipelines.config.distributed.local_parallel:dask_client"