diff --git a/README b/README.md
similarity index 91%
rename from README
rename to README.md
index 9b8b4364..a34176fe 100644
--- a/README
+++ b/README.md
@@ -1,4 +1,4 @@
-README for Sequencer64 0.96.8 (Native JACK, CLI, tempo, Linux/Windows, play-lists)
+# README for Sequencer64 0.96.8 (Native JACK, CLI, tempo, Linux/Windows, play-lists)
 Chris Ahlstrom
 2015-09-10 to 2020-07-05
 
@@ -12,14 +12,14 @@ added equipment.  It has an extensive manual and Windows installers:
 Sequencer64 has build options for ALSA, PortMidi, JACK, Gtkmm 2.4, Qt 5, Windows,
 and a command-line/daemon.
 
-Native JACK support: Seq64rtmidi/seq64
+## Native JACK support: Seq64rtmidi/seq64
 
     Seq64 has native JACK MIDI/Transport, with virtual/manual ports and
     auto-connect like ALSA, based on RtMidi massively refactored. It falls
     back to ALSA support if JACK is not running.  See README.jack for basic
     instructions on native JACK.
 
-GUI-less application: Seq64rtmidi/seq64cli
+## GUI-less application: Seq64rtmidi/seq64cli
 
     The RtMidi/JACK version without a GUI.  Controlled via MIDI control events
     (start/stop events must be set up), it relies on a good working
@@ -27,7 +27,7 @@ GUI-less application: Seq64rtmidi/seq64cli
     loaded via play-lists (see data/nanomap.rc and data/seq64cli.rc).  Seq64cli
     supports a "daemonize" option and log-files.
 
-Windows support derived from PortMidi: Seq64qt5/qpseq64.exe
+## Windows support derived from PortMidi: Seq64qt5/qpseq64.exe
 
     Qpseq64 uses a Qt 5 user-interface based on Kepler34 and the Sequencer64
     PortMidi engine.  Windows built-in MIDI devices are detected, inaccessible
@@ -37,10 +37,10 @@ Windows support derived from PortMidi: Seq64qt5/qpseq64.exe
     be the official GUI of Seq66 (in the near future).  See README.windows for
     more information.
 
-See the INSTALL file for build-from-source instructions for Linux or Window,
+## See the INSTALL file for build-from-source instructions for Linux or Window,
 and using a conventional source tarball.
 
-Recent changes:
+## Recent changes:
 
     -   Version 0.96.8:
         -   Reduced the size of the pattern editor to 800x480 to fit on small
@@ -81,5 +81,3 @@ This package is oriented to developers and users who do not mind building from
 source, with a little help.  It is organized and well documented.
 Initial work/thought/documentation started in July of 2015, when I was laid
 up after some old-man surgery :-(.
-
-# vim: sw=4 ts=4 wm=4 et ft=sh