A few changes to undo some of what was done diegobz and correcting a few changes I've missed.

Author: cmacmackin

.gitignore

@@ -1,4 +1,3 @@
-*.rst
 *~
 markdown_include.egg-info/
 dist/

README.rst

@@ -0,0 +1,54 @@
+Markdown-Include
+================
+
+This is an extension to
+`Python-Markdown <https://pythonhosted.org/Markdown/>`__ which provides
+an "include" function, similar to that found in LaTeX (and also the C
+pre-processor and Fortran). I originally wrote it for my
+`FORD <https://pypi.python.org/pypi/FORD>`__ Fortran auto-documentation
+generator.
+
+Installation
+------------
+
+This module can now be installed using ``pip``.
+
+::
+
+    pip install markdown-include
+
+Usage
+-----
+
+This module can be used in a program in the following way:
+
+::
+
+    import markdown
+    html = markdown.markdown(source, extensions=[markdown_include.include'])
+
+The syntax for use within your Markdown files is ``{!filename!}``. This
+statement will be replaced by the contents of ``filename``.
+Markdown-Include will work recursively, so any included files within
+``filename`` wil also be included. This replacement is done prior to any
+other Markdown processing, so any Markdown syntax that you want can be used
+within your included files. Note that this is a change from the previous 
+version. It was felt that this syntax was less likely to conflict with any code
+fragments present in the Markdown.
+
+By default, all file-names are evaluated relative to the location from
+which Markdown is being called. If you would like to change the
+directory relative to which paths are evaluated, then this can be done
+by specifying the extension setting ``base_path``.
+
+::
+
+    import markdown
+    from markdown_include.include import MarkdownInclude
+
+    # Markdown Extensions
+    markdown_include = MarkdownInclude(
+        configs={'base_path':'/srv/content/', 'encoding': 'iso-8859-1'}
+    )
+    html = markdown.markdown(source, extensions=[markdown_include])
+

markdown_include/include.py

@@ -52,7 +52,7 @@ def extendMarkdown(self, md, md_globals):
 class IncludePreprocessor(Preprocessor):
     '''
     This provides an "include" function for Markdown, similar to that found in
-    LaTeX (also the C pre-processor and Fortran). The syntax is {{filename}},
+    LaTeX (also the C pre-processor and Fortran). The syntax is {!filename!},
     which will be replaced by the contents of filename. Any such statements in
     filename will also be replaced. This replacement is done prior to any other
     Markdown processing. All file-names are evaluated relative to the location

setup.py

@@ -5,7 +5,7 @@
 here = path.abspath(path.dirname(__file__))
 
 # Get the long description from the relevant file
-with open(path.join(here, 'README.md'), encoding='utf-8') as f:
+with open(path.join(here, 'README.rst'), encoding='utf-8') as f:
     long_description = f.read()
 
 setup(