diff --git a/README b/README.md
similarity index 100%
rename from README
rename to README.md
diff --git a/certificates/README b/certificates/README.md
similarity index 100%
rename from certificates/README
rename to certificates/README.md
diff --git a/cookbooks/README b/cookbooks/README.md
similarity index 100%
rename from cookbooks/README
rename to cookbooks/README.md
diff --git a/data_bags/README b/data_bags/README.md
similarity index 100%
rename from data_bags/README
rename to data_bags/README.md
diff --git a/roles/README b/roles/README.md
similarity index 100%
rename from roles/README
rename to roles/README.md