<div dir="ltr"><div>In ReStructuredText, this gets syntax highlighted</div><div>because of the code directive [1][2][3]:</div><div><br></div>.. code:: python<div><br></div><div>   import this</div><div>   def func(*args, **kwargs):</div><div>       pass</div><div><br></div><div>This also gets syntax highlighted as python[3]:</div><div><br></div><div>.. code:: python<div><br></div><div>   import this</div><div>   def func(*args, **kwargs):</div><div>       pass</div></div><div><br></div><div>This does not::</div><div><div><br class="gmail-Apple-interchange-newline">   import this</div><div>   def func(*args, **kwargs):</div><div>       pass</div></div><div><br></div><div>Syntax highlighting in Docutils 0.9+ is powered by Pygments.</div><div>If Pygments is not installed, or there is a syntax error,</div><div>syntax highlighting is absent.</div><div><br></div><div>GitHub does show Pygments syntax highlighting</div><div>in .. code:: blocks for .rst and .restructuredtext documents [4]</div><div><br></div><div>1. Does the <a href="http://python.org">python.org</a> PEP view support .. code:: blocks? [5]</div><div>2. Syntax highlighting is an advantage for writers, editors, and readers.</div><div>3. Should PEPs use .. code:: blocks to provide this advantage?</div><div><br></div><div>[1] <a href="http://docutils.sourceforge.net/docs/ref/rst/directives.html#code">http://docutils.sourceforge.net/docs/ref/rst/directives.html#code</a></div><div>[2] <a href="http://www.sphinx-doc.org/en/stable/markup/code.html">http://www.sphinx-doc.org/en/stable/markup/code.html</a></div><div>[3] <a href="http://www.sphinx-doc.org/en/stable/config.html#confval-highlight_language">http://www.sphinx-doc.org/en/stable/config.html#confval-highlight_language</a></div><div>[4] <a href="https://github.com/python/peps/blob/master/pep-0557.rst">https://github.com/python/peps/blob/master/pep-0557.rst</a></div><div>[5] <a href="https://www.python.org/dev/peps/pep-0557/">https://www.python.org/dev/peps/pep-0557/</a></div><div><br></div><div><a href="https://www.python.org/dev/peps/pep-0458/">https://www.python.org/dev/peps/pep-0458/</a></div></div>