diff --git a/docs/determinism.rst b/docs/determinism.md
similarity index 51%
rename from docs/determinism.rst
rename to docs/determinism.md
index e3fbce3d6..95958bb1f 100644
--- a/docs/determinism.rst
+++ b/docs/determinism.md
@@ -1,8 +1,5 @@
-On Determinism
-==============
+# On Determinism
 
 Arguably, the most difficult part of blockchain programming is determinism - that is, ensuring that sources of indeterminism do not creep into the design of such systems.
 
-See `this issue <https://github.com/tendermint/abci/issues/56>`__ for more information on the potential sources of indeterminism.
-
-
+See [this issue](https://github.com/tendermint/abci/issues/56) for more information on the potential sources of indeterminism.
diff --git a/docs/ecosystem.md b/docs/ecosystem.md
new file mode 100644
index 000000000..4accd610f
--- /dev/null
+++ b/docs/ecosystem.md
@@ -0,0 +1,21 @@
+# Tendermint Ecosystem
+
+The growing list of applications built using various pieces of the
+Tendermint stack can be found at:
+
+-   https://tendermint.com/ecosystem
+
+We thank the community for their contributions thus far and welcome the
+addition of new projects. A pull request can be submitted to [this
+file](https://github.com/tendermint/aib-data/blob/master/json/ecosystem.json)
+to include your project.
+
+## Other Tools
+
+See [deploy testnets](./deploy-testnets.html) for information about all
+the tools built by Tendermint. We have Kubernetes, Ansible, and
+Terraform integrations.
+
+For upgrading from older to newer versions of tendermint and to migrate
+your chain data, see [tm-migrator](https://github.com/hxzqlh/tm-tools)
+written by @hxzqlh.
diff --git a/docs/ecosystem.rst b/docs/ecosystem.rst
deleted file mode 100644
index cfd3a6e55..000000000
--- a/docs/ecosystem.rst
+++ /dev/null
@@ -1,15 +0,0 @@
-Tendermint Ecosystem
-====================
-
-The growing list of applications built using various pieces of the Tendermint stack can be found at:
-
-* https://tendermint.com/ecosystem
-
-We thank the community for their contributions thus far and welcome the addition of new projects. A pull request can be submitted to `this file <https://github.com/tendermint/aib-data/blob/master/json/ecosystem.json>`__ to include your project.
-
-Other Tools
------------
-
-See `deploy testnets <./deploy-testnets.html>`__ for information about all the tools built by Tendermint. We have Kubernetes, Ansible, and Terraform integrations.
-
-For upgrading from older to newer versions of tendermint and to migrate your chain data, see `tm-migrator <https://github.com/hxzqlh/tm-tools>`__ written by @hxzqlh.