diff --git a/Makefile b/Makefile
index 382db4c..e073344 100644
--- a/Makefile
+++ b/Makefile
@@ -16,7 +16,7 @@ help:
 	@echo 'lint	run shellcheck'
 	@echo 'docs	build documentation from $(docs_dir)'
 	@echo
-	@echo See README.rst for more info.
+	@echo See README.md for more info.
 
 tests:
 	# See bats(1), https://bats-core.readthedocs.io/en/latest/index.html
diff --git a/README.rst b/README.md
similarity index 75%
rename from README.rst
rename to README.md
index c505246..81f719f 100644
--- a/README.rst
+++ b/README.md
@@ -1,25 +1,23 @@
-Testing
-=======
+# Testing
 
 Baf uses amazing test suite: https://bats-core.readthedocs.io/
 
-Install Bats::
+Install Bats:
 
     git clone https://github.com/bats-core/bats-core.git
     bash bats-core/install.sh ~/.local
 
-Add some Bats extensions::
+Add some Bats extensions:
 
     git clone https://github.com/bats-core/bats-assert.git tests/helpers/bats-assert
     git clone https://github.com/bats-core/bats-support.git tests/helpers/bats-support
 
-Run tests::
+Run tests:
 
     make tests
 
-Building
-========
+# Building
 
-Build docs (manpage and HTML)::
+Build docs (manpage and HTML):
 
     make docs