/
usr
/
share
/
doc
/
python2-markdown-2.4.1
/
Upload File
HOME
<!DOCTYPE html> <html> <head> <meta charset=utf-8> <title>Release Notes for v2.4 — 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="release-2.3.html" title="Release Notes for v2.3" accesskey="N">next</a> |</li> <li class="right"> <a href="change_log.html" title="Change Log" 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.4.1 documentation</a> »</li> <li><a href="release-2.4.html">Release Notes for v2.4</a> »</li> </ul> </div> <!-- .related --> <div class="document"> <div class="documentwrapper"> <div class="bodywrapper"> <div class="body"> <h1 id="python-markdown-24-release-notes">Python-Markdown 2.4 Release Notes<a class="headerlink" href="#python-markdown-24-release-notes" title="Permanent link">¶</a></h1> <p>We are pleased to release Python-Markdown 2.4 which adds one new extension and fixes various bugs. See the list of changes below for details.</p> <p>Python-Markdown supports Python versions 2.6, 2.7, 3.1, 3.2, and 3.3.</p> <h2 id="backwards-incompatible-changes">Backwards-incompatible Changes<a class="headerlink" href="#backwards-incompatible-changes" title="Permanent link">¶</a></h2> <ul> <li> <p>The “force_linenos” config setting of the CodeHilite extension has been marked as <strong>Deprecated</strong>. It had previously been marked as “Pending Deprecation” in version 2.3 when a new setting “linenums” was added to replace it. See documentation for the <a href="extensions/code_hilite.html">CodeHilite Extension</a> for an explanation of the new “linenums” setting. The new setting will honor the old “force_linenos” if it is set, but “force_linenos” will raise a DeprecationWarning and will likely be removed in a future version of Python-Markdown.</p> </li> <li> <p>URLs are no longer percent-encoded. This improves compatibility with the original (written in Perl) Markdown implementation. Please percent-encode your URLs manually when needed.</p> </li> </ul> <h2 id="whats-new-in-python-markdown-24">What’s New in Python-Markdown 2.4<a class="headerlink" href="#whats-new-in-python-markdown-24" title="Permanent link">¶</a></h2> <ul> <li> <p>Thanks to the hard work of <a href="https://github.com/mitya57">Dmitry Shachnev</a> the <a href="extensions/smarty.html">Smarty Extension</a> has been added, which implements <a href="http://daringfireball.net/projects/smartypants/">SmartyPants</a> using Python-Markdown’s Extension API. This offers a few benefits over a third party sript. The HTML does not need to be “tokenized” twice, no hacks are required to combine SmartyPants and code highlighting, and we get markdown’s escaping feature for free. Please try it out and report bugs and/or improvements.</p> </li> <li> <p>The <a href="extensions/toc.html">Table of Contents Extension</a> now supports new <code>permalink</code> option for creating <a href="http://sphinx-doc.org/">Sphinx</a>-style anchor links.</p> </li> <li> <p>It is now possible to enable Markdown formatting inside HTML blocks by appending <code>markdown=1</code> to opening tag attributes. See <a href="extensions/extra.html#nested-markdown-inside-html-blocks">Markdown Inside HTML Blocks</a> section for details. Thanks to <a href="https://github.com/ryneeverett">ryneeverett</a> for implementing this feature.</p> </li> <li> <p>The code blocks now support emphasizing some of the code lines. To use this feature, specify <code>hl_lines</code> option after language name, for example (using the <a href="extensions/fenced_code_blocks.html">Fenced Code Extension</a>):</p> <pre><code>```.python hl_lines="1 3" # This line will be emphasized. # This one won't. # This one will be also emphasized. ``` </code></pre> <p>Thanks to <a href="https://github.com/ajdavis">A. Jesse Jiryu Davis</a> for implementing this feature.</p> </li> <li> <p>Various bug fixes have been made. See the <a href="https://github.com/waylan/Python-Markdown/commits/master">commit log</a> for a complete history of the changes.</p> </li> </ul> </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-24-release-notes">Python-Markdown 2.4 Release Notes</a><ul> <li><a href="#backwards-incompatible-changes">Backwards-incompatible Changes</a></li> <li><a href="#whats-new-in-python-markdown-24">What’s New in Python-Markdown 2.4</a></li> </ul> </li> </ul> </div> <h4>Previous topic</h4> <p class="topless"><a href="change_log.html" title="previous chapter">Change Log</a></p> <h4>Next topic</h4> <p class="topless"><a href="release-2.3.html" title="next chapter">Release Notes for v2.3</a></p> <h3>This Page</h3> <ul class="this-page-menu"> <li><a href="https://github.com/waylan/Python-Markdown/issues" >Report a Bug</a></li> <li><a href="release-2.4.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="release-2.3.html" title="Release Notes for v2.3" accesskey="N">next</a> |</li> <li class="right"> <a href="change_log.html" title="Change Log" 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.4.1 documentation</a> »</li> <li><a href="release-2.4.html">Release Notes for v2.4</a> »</li> </ul> </div> <!-- .related --> <div class="footer">© 2010-2012 Python Markdown Project</div> </body> </html>