Added trivial examples to extension docs

Fixes Python-Markdown#854.

docs/extensions/abbreviations.md

@@ -43,3 +43,9 @@ See [Extensions](index.md) for general extension usage. Use `abbr` as the name
 of the extension.
 
 This extension does not accept any special configuration options.
+
+A trivial example:
+
+```python
+markdown.markdown(some_text, extensions=['abbr'])
+```

docs/extensions/admonition.md

@@ -107,3 +107,9 @@ See [Extensions](index.md) for general extension usage. Use `admonition` as the
 name of the extension.
 
 This extension does not accept any special configuration options.
+
+A trivial example:
+
+```python
+markdown.markdown(some_text, extensions=['admonition'])
+```

docs/extensions/attr_list.md

@@ -96,3 +96,9 @@ See [Extensions](index.md) for general extension usage. Use `attr_list` as the
 name of the extension.
 
 This extension does not accept any special configuration options.
+
+A trivial example:
+
+```python
+markdown.markdown(some_text, extensions=['attr_list'])
+```

docs/extensions/code_hilite.md

@@ -221,5 +221,11 @@ The following options are provided to configure the output:
     `<code>` tag as a class in the manner suggested by the [HTML5 spec][spec]
     (alternate output will not be entertained) and might be used by a JavaScript
     library in the browser to highlight the code block.
+
+A trivial example:
+
+```python
+markdown.markdown(some_text, extensions=['codehilite'])
+```
 
 [spec]: https://www.w3.org/TR/html5/text-level-semantics.html#the-code-element

docs/extensions/definition_lists.md

@@ -50,3 +50,9 @@ See [Extensions](index.md) for general extension usage. Use `def_list` as the
 name of the extension.
 
 This extension does not accept any special configuration options.
+
+A trivial example:
+
+```python
+markdown.markdown(some_text, extensions=['def_list'])
+```

docs/extensions/fenced_code_blocks.md

@@ -64,7 +64,7 @@ The above will output:
 </code></pre>
 ```
 
-[GitHub][]'s backtick (`\``) syntax is also supported:
+[GitHub][]'s backtick (`\``) syntax is also supported in this extension:
 
 ````md
 ```python
@@ -114,3 +114,9 @@ See [Extensions](index.md) for general extension usage. Use `fenced_code` as
 the name of the extension.
 
 This extension does not accept any special configuration options.
+
+A trivial example:
+
+```python
+markdown.markdown(some_text, extensions=['fenced_code'])
+```

docs/extensions/footnotes.md

@@ -93,3 +93,9 @@ The following options are provided to configure the output:
 
 * **`SEPARATOR`**:
     The text string used to set the footnote separator. Defaults to `:`.
+
+A trivial example:
+
+```python
+markdown.markdown(some_text, extensions=['footnotes'])
+```

docs/extensions/legacy_attr.md

@@ -57,3 +57,9 @@ See [Extensions](index.md) for general extension usage. Use `legacy_attr` as the
 name of the extension.
 
 This extension does not accept any special configuration options.
+
+A trivial example:
+
+```python
+markdown.markdown(some_text, extensions=['legacy_attr'])
+```

docs/extensions/legacy_em.md

@@ -23,3 +23,9 @@ See [Extensions](index.md) for general extension usage. Use `legacy_em` as the
 name of the extension.
 
 This extension does not accept any special configuration options.
+
+A trivial example:
+
+```python
+markdown.markdown(some_text, extensions=['legacy_em'])
+```

docs/extensions/meta_data.md

@@ -60,6 +60,12 @@ Usage
 See [Extensions](index.md) for general extension usage. Use `meta` as the name
 of the extension.
 
+A trivial example:
+
+```python
+markdown.markdown(some_text, extensions=['meta'])
+```
+
 Accessing the Meta-Data
 -----------------------
 

docs/extensions/nl2br.md

@@ -33,3 +33,9 @@ See [Extensions](index.md) for general extension usage. Use `nl2br` as the name
 of the extension.
 
 This extension does not accept any special configuration options.
+
+A trivial example:
+
+```python
+markdown.markdown(some_text, extensions=['nl2br'])
+```

docs/extensions/sane_lists.md

@@ -96,3 +96,9 @@ See [Extensions](index.md) for general extension usage. Use `sane_lists` as the
 name of the extension.
 
 This extension does not accept any special configuration options.
+
+A trivial example:
+
+```python
+markdown.markdown(some_text, extensions=['sane_lists'])
+```

docs/extensions/smarty.md

@@ -69,6 +69,12 @@ Option                | Default value | Description
 `smart_ellipses`      | `True`        | whether to convert ellipses
 `substitutions`       | `{}`          | overwrite default substitutions
 
+A trivial example:
+
+```python
+markdown.markdown(some_text, extensions=['smarty'])
+```
+
 Further reading
 ---------------
 

docs/extensions/tables.md

@@ -56,3 +56,9 @@ See [Extensions](index.md) for general extension usage. Use `tables` as the
 name of the extension.
 
 This extension does not accept any special configuration options.
+
+A trivial example:
+
+```python
+markdown.markdown(some_text, extensions=['tables'])
+```

docs/extensions/toc.md

@@ -208,4 +208,10 @@ The following options are provided to configure the output:
     will be present in the table. If you set `baselevel` to `3` and
     `toc_depth` to `"2-6"`, the *first* headline will be `<h3>` and so still
     included in the Table of Contents. To exclude this first level, you
-    have to set `toc_depth` to `"4-6"`.
+    have to set `toc_depth` to `"4-6"`.
+
+A trivial example:
+
+```python
+markdown.markdown(some_text, extensions=['toc'])
+```

docs/extensions/wikilinks.md

@@ -72,6 +72,12 @@ The following options are provided to change the default behavior:
 
 * **`build_url`**: Callable which formats the URL from its parts.
 
+A trivial example:
+
+```python
+markdown.markdown(some_text, extensions=['wikilinks'])
+```
+
 ### Examples
 
 For an example, let us suppose links should always point to the sub-directory