doc changes

README → README.md

-WHAT IT IS
-----------
+# WHAT IT IS
 
-GStreamer plugin that wraps Kaldi's SingleUtteranceNnet2Decoder. It uses iVector-adapted
+
+GStreamer plugin that wraps Kaldi's SingleUtteranceNnet2Decoder. It requires iVector-adapted
 DNN acoustic models. The iVectors are adapted to the current audio stream automatically.
 
 The iVectors are reset after the decoding session (stream) ends.
-Currently, it's not possible to save the adapted iVectors and recall them later
+Currently, it's not possible to save the adaptation state and recall it later
 for a particular speaker, to make the adaptation persistent over multiple decoding
 sessions.
 
 
-HOW TO COMPILE IT
------------------
+# HOW TO COMPILE IT
 
 The following works on Linux (I'm using Debian 'testing').
 
@@ -26,7 +25,7 @@ Install gstreamer-1.0:
 
     sudo apt-get install gstreamer1.0-plugins-bad  gstreamer1.0-plugins-base gstreamer1.0-plugins-good  gstreamer1.0-pulseaudio  gstreamer1.0-plugins-ugly  gstreamer1.0-tools libgstreamer1.0-dev
 
-Now we can compile this plugin. Change to 'src' of this project:
+Now we can compile this plugin. Change to `src` of this project:
 
     cd src
 
@@ -42,13 +41,12 @@ Test if GStreamer can access the plugin:
     GST_PLUGIN_PATH=. gst-inspect-1.0 kaldinnet2onlinedecoder
 
 
-HOW TO USE IT
--------------
+# HOW TO USE IT
 
 Command-line usage is demonstrated in `demo/`.
 
 Usage through GSTreamer's Python bindings is demonstrated in
-https://github.com/alumae/kaldi-gstreamer-server (kaldigstserver/decoder2.py).
+https://github.com/alumae/kaldi-gstreamer-server/kaldigstserver/decoder2.py.