diff --git a/boards/readme.markdown b/boards/readme.md
similarity index 100%
rename from boards/readme.markdown
rename to boards/readme.md
diff --git a/readme.md b/readme.markdown
similarity index 100%
rename from readme.md
rename to readme.markdown
diff --git a/tests/readme.markdown b/tests/readme.md
similarity index 100%
rename from tests/readme.markdown
rename to tests/readme.md
diff --git a/tinyusb.Doxyfile b/tinyusb.Doxyfile
index 5f92c1cee..8be8b1678 100644
--- a/tinyusb.Doxyfile
+++ b/tinyusb.Doxyfile
@@ -744,10 +744,10 @@ WARN_LOGFILE           =
 # Note: If this tag is empty the current directory is searched.
 
 INPUT                  = tinyusb/doxygen/group_def.txt \
-                         readme.md \
+                         readme.markdown \
                          tinyusb \
                          boards \
-                         tests/readme.markdown
+                         tests/readme.md
 
 # This tag can be used to specify the character encoding of the source files
 # that doxygen parses. Internally doxygen uses the UTF-8 encoding. Doxygen uses
@@ -925,7 +925,7 @@ FILTER_SOURCE_PATTERNS =
 # (index.html). This can be useful if you have a project on for instance GitHub
 # and want to reuse the introduction page also for the doxygen output.
 
-USE_MDFILE_AS_MAINPAGE = readme.md
+USE_MDFILE_AS_MAINPAGE = readme.markdown
 
 #---------------------------------------------------------------------------
 # Configuration options related to source browsing
diff --git a/tinyusb/doxygen/get_started.md b/tinyusb/doxygen/get_started.md
new file mode 100644
index 000000000..e69de29bb