diff --git a/README.md b/README.md
index 10e5f1b..e356c1e 100644
--- a/README.md
+++ b/README.md
@@ -1,17 +1,22 @@
-# feedprefs plugin
+feedprefs plugin
+================
 
 Plugin for [Tiny Tiny RSS](https://tt-rss.org/) to make display preferences
 specific to each feed.
 
-# Installation
 
-- git clone the repository or install a copy in the plugins.local directory of
+Installation
+------------
+
+- git clone the repository or download a copy in the plugins.local directory of
   your tt-rss install.
-- Inside tt-rss, go to Configuration and enable the 'feedprefs' plugin
+- Inside tt-rss, go to Configuration and enable the `feedprefs` plugin
 
-# Usage
 
-each time you open a feed, View mode and Ordering Mode is restored to the same
+Usage
+-----
+
+Each time you open a feed, View mode and Ordering Mode is restored to the same
 state than the last time you visited the feed.
 
 State is stored in broswer local storage. This means state is not shared if