Generar enlaces permanentes en la cabecera con la biblioteca de Python rebaja

Question

me preguntaba cómo generar vínculos permanentes de la siguiente marcado, usando la biblioteca pitón de rebajas:

A header 
======== 

A paragraph 

La salida deseada sería algo así como

<span id="a-header"></span> 
<h1> 
    A header 
    <a class="headerlink" title="Permalink to this headline" href="#a-header">¶</a> 
</h1> 
<p>A paragraph</p> 

---

Respuesta:

Gracias s @BlaXpirit extensión de rebajas (see answer)

Uso headerid pitón y de entrada lo siguiente:

# A header [¶](#a-header) {#a-header} 

A paragraph 

Esto genera el siguiente resultado:

<h1 id="a-header"> 
    A header 
    <a href="#a-header">¶</a> 
</h1> 

A continuación, utilice algo más de estilo CSS para obtener la salida común , algo así como:

h1 a{visibility:hidden;} 
h1:hover a{visibility:visible;} 

Answer 1

Markdown en Python tiene un extension que hace esto.
También permite especificar una Identificación te gusta para la cabecera, así:

 
A header   {#a-header} 
======== 

Answer 2

Pandoc asocia un identificador único a cada cabecera basado en la regla de lo que imaginaba: el id es el título downcase, espacios reemplazar por guiones. Esto se usa para generar tablas de contenido opcionales para HTML y LaTeX y otros formatos de salida. En HTML, hace automáticamente identificadores enlazables y, en particular, puede usarse para referencias cruzadas internas; la sintaxis de reducción del precio es:

See the section on [header identifiers](#header-identifiers-in-html). 

como se lee en la guía del usuario en http://johnmacfarlane.net/pandoc/README.html#header-identifiers-in-html