/usr/share/doc/python-markdown-doc/docs/extensions/extra.html is in python-markdown-doc 2.6.9-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 | <!DOCTYPE html>
<html>
<head>
<meta charset=utf-8>
<title>Extra Extension — Python Markdown</title>
<link rel="stylesheet" href="../default.css" type="text/css">
</head>
<body>
<div class="related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="../siteindex.html" title="General Index">index</a></li>
<li class="right">
<a href="abbreviations.html" title="Abbreviations Extension"
accesskey="N">next</a> |</li>
<li class="right">
<a href="index.html" title="Extensions"
accesskey="P">previous</a> |</li>
<li><img src="../py.png" alt=""
style="vertical-align: middle; margin-top: -1px"/></li>
<li><a href="../index.html">Python Markdown v2.6.9 documentation</a> »</li>
<li><a href="index.html">Extensions</a> »</li>
<li><a href="extra.html">Extra Extension</a> »</li>
</ul>
</div> <!-- .related -->
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body">
<h1 id="python-markdown-extra">Python-Markdown Extra<a class="headerlink" href="#python-markdown-extra" title="Permanent link">¶</a></h1>
<h2 id="summary">Summary<a class="headerlink" href="#summary" title="Permanent link">¶</a></h2>
<p>A compilation of various Python-Markdown extensions that (mostly) imitates
<a href="http://michelf.com/projects/php-markdown/extra/">PHP Markdown Extra</a>.</p>
<p>The supported extensions include:</p>
<ul>
<li><a href="abbreviations.html">Abbreviations</a></li>
<li><a href="attr_list.html">Attribute Lists</a></li>
<li><a href="definition_lists.html">Definition Lists</a></li>
<li><a href="fenced_code_blocks.html">Fenced Code Blocks</a></li>
<li><a href="footnotes.html">Footnotes</a></li>
<li><a href="tables.html">Tables</a></li>
<li><a href="smart_strong.html">Smart Strong</a></li>
</ul>
<p>See each individual extension for syntax documentation. Extra and all its
supported extensions are included in the standard Markdown library.</p>
<h2 id="usage">Usage<a class="headerlink" href="#usage" title="Permanent link">¶</a></h2>
<p>From the Python interpreter:</p>
<pre><code>>>> import markdown
>>> html = markdown.markdown(text, ['markdown.extensions.extra'])
</code></pre>
<p>There may be <a href="index.html">additional extensions</a> that are distributed with
Python-Markdown that are not included here in Extra. The features
of those extensions are not part of PHP Markdown Extra, and
therefore, not part of Python-Markdown Extra. If you really would
like Extra to include additional extensions, we suggest creating
your own clone of Extra under a different name
(see the <a href="api.html">Extension API</a>). </p>
<h2 id="markdown-inside-html-blocks">Markdown Inside HTML Blocks<a class="headerlink" href="#markdown-inside-html-blocks" title="Permanent link">¶</a></h2>
<p>Unlike the other Extra features, this feature is built into the markdown core and
is turned on when <code>markdown.extensions.extra</code> is enabled.</p>
<p>The content of any raw HTML block element can be Markdown-formatted simply by
adding a <code>markdown</code> attribute to the opening tag. The markdown attribute will be
stripped from the output, but all other attributes will be preserved.</p>
<p>If the markdown value is set to <code>1</code> (recommended) or any value other than <code>span</code>
or <code>block</code>, the default behavior will be executed: <code>p</code>,<code>h[1-6]</code>,<code>li</code>,<code>dd</code>,<code>dt</code>,
<code>td</code>,<code>th</code>,<code>legend</code>, and <code>address</code> elements skip block parsing while others do not.
If the default is overridden by a value of <code>span</code>, <em>block parsing will be skipped</em>
regardless of tag. If the default is overridden by a value of <code>block</code>,
<em>block parsing will occur</em> regardless of tag.</p>
<h4 id="simple-example">Simple Example:<a class="headerlink" href="#simple-example" title="Permanent link">¶</a></h4>
<pre><code>This is *true* markdown text.
<div markdown="1">
This is *true* markdown text.
</div>
</code></pre>
<h4 id="result">Result:<a class="headerlink" href="#result" title="Permanent link">¶</a></h4>
<pre><code><p>This is <em>true</em> markdown text.</p>
<div>
<p>This is <em>true</em> markdown text.</p>
</div>
</code></pre>
<h3 id="nested-markdown-inside-html-blocks">Nested Markdown Inside HTML Blocks<a class="headerlink" href="#nested-markdown-inside-html-blocks" title="Permanent link">¶</a></h3>
<p>Nested elements are more sensitive and must be used cautiously. To avoid
unexpected results:</p>
<ul>
<li>Only nest elements within block mode elements.</li>
<li>Follow the closing tag of inner elements with a blank line.</li>
<li>Only have one level of nesting.</li>
</ul>
<h4 id="complex-example">Complex Example:<a class="headerlink" href="#complex-example" title="Permanent link">¶</a></h4>
<pre><code><div markdown="1" name="Example">
The text of the `Example` element.
<div markdown="1" name="DefaultBlockMode">
This text gets wrapped in `p` tags.
</div>
The tail of the `DefaultBlockMode` subelement.
<p markdown="1" name="DefaultSpanMode">
This text *is not* wrapped in additional `p` tags.
</p>
The tail of the `DefaultSpanMode` subelement.
<div markdown="span" name="SpanModeOverride">
This `div` block is not wrapped in paragraph tags.
Note: Subelements are not required to have tail text.
</div>
<p markdown="block" name="BlockModeOverride">
This `p` block *is* foolishly wrapped in further paragraph tags.
</p>
The tail of the `BlockModeOverride` subelement.
<div name="RawHtml">
Raw HTML blocks may also be nested.
</div>
</div>
This text is after the markdown in HTML.
</code></pre>
<h4 id="result_1">Result:<a class="headerlink" href="#result_1" title="Permanent link">¶</a></h4>
<pre><code><div name="Example">
<p>The text of the <code>Example</code> element.</p>
<div name="DefaultBlockMode">
<p>This text gets wrapped in <code>p</code> tags.</p>
</div>
<p>The tail of the <code>DefaultBlockMode</code> subelement.</p>
<p name="DefaultSpanMode">
This text <em>is not</em> wrapped in additional <code>p</code> tags.</p>
<p>The tail of the <code>DefaultSpanMode</code> subelement.</p>
<div name="SpanModeOverride">
This <code>div</code> block is not wrapped in paragraph tags.
Note: Subelements are not required to have tail text.</div>
<p name="BlockModeOverride">
<p>This <code>p</code> block <em>is</em> foolishly wrapped in further paragraph tags.</p>
</p>
<p>The tail of the <code>BlockModeOverride</code> subelement.</p>
<div name="RawHtml">
Raw HTML blocks may also be nested.
</div>
</div>
<p>This text is after the markdown in HTML.</p>
</code></pre>
</div> <!-- .body -->
</div> <!-- .bodywrapper -->
</div> <!-- .documentwrapper -->
<div class="sphinxsidebar">
<div class="sphinxsidebarwrapper">
<h3>Table Of Contents</h3>
<div class="toc">
<ul>
<li><a href="#python-markdown-extra">Python-Markdown Extra</a><ul>
<li><a href="#summary">Summary</a></li>
<li><a href="#usage">Usage</a></li>
<li><a href="#markdown-inside-html-blocks">Markdown Inside HTML Blocks</a><ul>
<li><a href="#simple-example">Simple Example:</a></li>
<li><a href="#result">Result:</a></li>
<li><a href="#nested-markdown-inside-html-blocks">Nested Markdown Inside HTML Blocks</a><ul>
<li><a href="#complex-example">Complex Example:</a></li>
<li><a href="#result_1">Result:</a></li>
</ul>
</li>
</ul>
</li>
</ul>
</li>
</ul>
</div>
<h4>Previous topic</h4>
<p class="topless"><a href="index.html"
title="previous chapter">Extensions</a></p>
<h4>Next topic</h4>
<p class="topless"><a href="abbreviations.html"
title="next chapter">Abbreviations Extension</a></p>
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="https://github.com/Python-Markdown/markdown/issues"
>Report a Bug</a></li>
<li><a href="extra.txt"
rel="nofollow">Show Source</a></li>
</ul>
</div> <!-- .sphinxsidebarwrapper -->
</div> <!-- .sphinxsidebar -->
<div class="clearer"></div>
</div> <!-- .document -->
<div class="related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="../siteindex.html" title="General Index">index</a></li>
<li class="right">
<a href="abbreviations.html" title="Abbreviations Extension"
accesskey="N">next</a> |</li>
<li class="right">
<a href="index.html" title="Extensions"
accesskey="P">previous</a> |</li>
<li><img src="../py.png" alt=""
style="vertical-align: middle; margin-top: -1px"/></li>
<li><a href="../index.html">Python Markdown v2.6.9 documentation</a> »</li>
<li><a href="index.html">Extensions</a> »</li>
<li><a href="extra.html">Extra Extension</a> »</li>
</ul>
</div> <!-- .related -->
<div class="footer">© 2010-2012 Python Markdown Project</div>
</body>
</html>
|