Issue #3322038: Replace README.txt with README.md

README.md

-Responsive Favicons
--------------------
+## Responsive Favicons module
 
-This module adds the favicons generated by http://realfavicongenerator.net/ to
+## Introduction
+
+Responsive Favicons module adds the favicons generated by http://realfavicongenerator.net/ to
 your site. The responsive name comes from the fact that many devices are
 catered for including iPhone, Android, iPad, other tablets and dektops.
 
@@ -11,16 +12,14 @@ to only a single site. This module allows you to store per site variations of
 the icons, in each site's respective public files directory.
 
 
-Requirements
-------------
+## Requirements
 
 * Drupal 8
 * Favicon files generated by http://realfavicongenerator.net/
 * HTML code generated by http://realfavicongenerator.net/
 
 
-Installation and configuration
-------------------------------
+## Installation and configuration
 
 1. Generate the favicons and the HTML code on http://realfavicongenerator.net/
 
@@ -34,7 +33,7 @@ Installation and configuration
    your configuration of the module for you.
 
 2. Install Responsive Favicons module as you install a contributed Drupal module.
-   See https://drupal.org/documentation/install/modules/themes/modules-7
+   See https://www.drupal.org/docs/extending-drupal/installing-modules
 
 3. Go to /admin/config/user-interface/responsive_favicons to configure the
    module.
@@ -52,25 +51,24 @@ Installation and configuration
    In order to do this you need to:
 
    1) Comment out the line
-
+   ```
    #RewriteCond %{REQUEST_URI} !=/favicon.ico
-
+   ```
    in the Drupal root .htaccess file.
 
    2) Alter the config setting system.performance.fast_404.exclude_paths in your settings.php file:
-
+   ```
    $config['system.performance']['fast_404']['exclude_paths'] = '/\/(?:styles)\/|(?:system\/files)\/|favicon\.ico|apple-touch-icon(?:-precomposed)?\.png|browserconfig\.xml/';
+   ```
+   You site will now output the required metadata for the favicons to work. You can
+   always check the status report page to find out if your site has been correctly
+   configured.
 
-You site will now output the required metadata for the favicons to work. You can
-always check the status report page to find out if your site has been correctly
-configured.
-
-Note. The 'favicon' module duplicates some of the functionality of responsive
-favicons, so it is preferred that you only install one of the two modules.
+   Note. The 'favicon' module duplicates some of the functionality of responsive
+   favicons, so it is preferred that you only install one of the two modules.
 
 
-Further reading
----------------
+## Further reading
 
 This entire module was spawned from a blog post on the topic located at
 http://www.pixelite.co.nz/article/adding-apple-android-favicons-drupal