diff --git a/{{cookiecutter.role_name}}/LICENSE.rst b/{{cookiecutter.role_name}}/LICENSE.md
similarity index 100%
rename from {{cookiecutter.role_name}}/LICENSE.rst
rename to {{cookiecutter.role_name}}/LICENSE.md
diff --git a/{{cookiecutter.role_name}}/README.md b/{{cookiecutter.role_name}}/README.md
new file mode 100644
index 0000000..a9552fb
--- /dev/null
+++ b/{{cookiecutter.role_name}}/README.md
@@ -0,0 +1,16 @@
+# {{cookiecutter.role_name}}
+
+{{cookiecutter.short_description}}
+
+## Usage
+
+`ansible-galaxy install {{ cookiecutter.role_name }}`
+
+LICENSE: 3-clause BSD license.
+
+## CONTRIBUTING
+
+`git clone git@github.com:{{cookiecutter.github_user}}/{{cookiecutter.repo_name}}`
+
+---
+Copyright © {{cookiecutter.year}}, {{ cookiecutter.full_name }}
diff --git a/{{cookiecutter.role_name}}/README.rst b/{{cookiecutter.role_name}}/README.rst
deleted file mode 100644
index 66ef6e5..0000000
--- a/{{cookiecutter.role_name}}/README.rst
+++ /dev/null
@@ -1,23 +0,0 @@
-{{cookiecutter.role_name}}
-===========================
-
-{{cookiecutter.short_description}}
-
-Usage
------
-
-ansible-galaxy install {{ cookiecutter.role_name }}
-
-LICENSE: 3-clause BSD license.
-
-CONTRIBUTING
-------------
-
-git clone git@github.com:{{cookiecutter.github_user}}/{{cookiecutter.repo_name}}
-
-please see CONTRIBUTING.rst
-
-
-
----
-Copyright © {{cookiecutter.year}}, {{ cookiecutter.full_name }}