Rename docs/*.md => docs/*.txt

The documentation uses features of Python-Markdown that are not supported on
GitHub and it's better to get a source view of the docs anyway. For example,
that way comments and bug reports can reference a specific line of a file.

Of course, it makes sense for Github to render the README, so that is left
with the `.md` file extension.

1 files changed, 25 insertions, 0 deletions

diff --git a/docs/extensions/nl2br.txt b/docs/extensions/nl2br.txt
new file mode 100644
index 0000000..affd8ee
--- /dev/null
+++ b/docs/extensions/nl2br.txt
@@ -0,0 +1,25 @@
+title:      New Line to Break Extension
+prev_title: Meta-Data Extension
+prev_url:   meta_data.html
+next_title: RSS Extension
+next_url:   rss.html
+
+NL2BR Extension
+===============
+
+A Python-Markdown extension to treat newlines as hard breaks; like
+StackOverflow and [GitHub][] flavored Markdown do.
+
+Usage:
+
+    >>> import markdown
+    >>> text = """
+    ... Line 1
+    ... Line 2
+    ... """
+    >>> html = markdown.markdown(text, extensions=['nl2br'])
+    >>> print html
+    <p>Line 1<br />
+    Line 2</p>
+
+[Github]: http://github.github.com/github-flavored-markdown/