section - ¿Cómo enlazar a parte del mismo documento en Markdown?
markdown syntax (11)
Algunos giros más en el truco de <a name=""> :
<a id="a-link"></a> Title
------
#### <a id="a-link"></a> Title (when you wanna control the h{N} with #''s)
Estoy escribiendo un gran documento de Markdown y me gustaría colocar una tabla de contenidos de orden al principio que proporcione enlaces a varias ubicaciones en el documento. ¿Cómo puedo hacer esto?
Traté de usar
[a link](# MyTitle)
donde MyTitle es un título dentro del documento y esto no funcionó.
Desde MultiMarkdown se mencionó como una opción en los comentarios.
En MultiMarkdown la sintaxis de un enlace interno es simple.
Para cualquier encabezado del documento, simplemente indique el nombre del encabezado en este formato [heading][] para crear un enlace interno.
Lea más aquí: MultiMarkdown-5 referencias cruzadas .
Referencias cruzadas
Una característica muy solicitada fue la posibilidad de que Markdown maneje automáticamente los enlaces dentro del documento con la misma facilidad con que manejaba los enlaces externos. Para este objetivo, agregué la capacidad de interpretar [Algunos textos] [] como un enlace cruzado, si existe un encabezado llamado "Algunos textos".
Como ejemplo, [Metadata] [] lo llevará a # Metadata (o cualquiera de ## Metadata, ### Metadata, ### Metadata, ##### Metadata, ###### Metadata).
Alternativamente, puede incluir una etiqueta opcional de su elección para ayudar a desconfigurar los casos en los que múltiples encabezados tienen el mismo título:
### Descripción general [MultiMarkdownOverview] ##
Esto le permite usar [MultiMarkdownOverview] para referirse a esta sección específicamente, y no a otra sección llamada Visión general. Esto funciona con los encabezados de estilo atx o settext.
Si ya ha definido un anclaje utilizando el mismo id que utiliza un encabezado, entonces el anclaje definido tiene prioridad.
Además de los encabezados dentro del documento, puede proporcionar etiquetas para imágenes y tablas que también se pueden usar para referencias cruzadas.
El manual de pandoc explica cómo enlazar a sus encabezados, usando su identificador. No comprobé el soporte de esto por otros analizadores, pero se informó que no funciona en github .
El identificador se puede especificar manualmente:
## my heading text {#mht}
Some normal text here,
including a [link to the header](#mht).
o puede utilizar el identificador generado automáticamente. Ambos se explican en detalle en el manual de pandoc .
NOTA : Esto solo funciona cuando se convierte a HTML , LaTex , ConTeXt , Textile o AsciiDoc .
En pandoc , si usa la opción --toc para producir html, se producirá una tabla de contenido con enlaces a las secciones y de vuelta a la tabla de contenido de los encabezados de las secciones. Es similar con los otros formatos que escribe pandoc, como LaTeX, rtf, rst, etc. Así que con el comando
pandoc --toc happiness.txt -o happiness.html
este bit de rebaja:
% True Happiness
Introduction
------------
Many have posed the question of true happiness. In this blog post we propose to
solve it.
First Attempts
--------------
The earliest attempts at attaining true happiness of course aimed at pleasure.
Soon, though, the downside of pleasure was revealed.
cederá esto como el cuerpo del html:
<h1 class="title">
True Happiness
</h1>
<div id="TOC">
<ul>
<li>
<a href="#introduction">Introduction</a>
</li>
<li>
<a href="#first-attempts">First Attempts</a>
</li>
</ul>
</div>
<div id="introduction">
<h2>
<a href="#TOC">Introduction</a>
</h2>
<p>
Many have posed the question of true happiness. In this blog post we propose to solve it.
</p>
</div>
<div id="first-attempts">
<h2>
<a href="#TOC">First Attempts</a>
</h2>
<p>
The earliest attempts at attaining true happiness of course aimed at pleasure. Soon, though, the downside of pleasure was revealed.
</p>
</div>
Experimentando, encontré una solución usando <div…/> pero una solución obvia es colocar su propio punto de anclaje en la página donde lo desee, por lo tanto:
<a name="abcde">
antes y
</a>
después de la línea a la que desea ''vincular''. A continuación, un enlace de rebaja como:
[link text](#abcde)
En cualquier parte del documento te lleva allí.
La solución <div…/> inserta una división "ficticia" solo para agregar la propiedad id , y esto es potencialmente perjudicial para la estructura de la página, pero la solución <a name="abcde"/> debería ser bastante inocua.
(PD: Podría estar bien colocar el ancla en la línea a la que desea enlazar, de la siguiente manera:
## <a name="head1">Heading One</a>
pero esto depende de cómo Markdown trata esto. Observo, por ejemplo, que el formateador de respuestas de está contento con esto.)
Github analiza automáticamente las etiquetas de anclaje de sus encabezados. Así que puedes hacer lo siguiente:
[Foo](#foo)
# Foo
En el caso anterior, el encabezado Foo ha generado una etiqueta de anclaje con el nombre foo
Nota : solo un # para todos los tamaños de encabezado, sin espacio entre # y nombre de ancla, los nombres de las etiquetas de anclaje deben estar en minúsculas, y delimitados por guiones si son de varias palabras.
[click on this link](#my-multi-word-header)
### My Multi Word Header
Actualizar
Trabaja fuera de la caja con pandoc también.
Gitlab utiliza GitLab Flavored Markdown (GFM)
Aquí, "todas las cabeceras de Markdown se obtienen automáticamente las ID"
Uno puede usar el ratón para:
- mover el mouse sobre el encabezado
- mueva el mouse sobre el selector de desplazamiento que se ve a la izquierda desde el encabezado
Copia y guarda el enlace con el botón derecho del ratón.
Por ejemplo, en el archivo README.md tengo un encabezado:
## series expansion formula of the Boettcher function
que da un enlace:
El prefijo se puede eliminar por lo que el enlace aquí es simplemente
[I want this to link to foo](#foo)
....
....
{: id="foo"}
### Foo are you?
lo que aquí significa:
[foo][#foo]
....
#Foo
Ahora se puede utilizar como:
[series expansion formula of the Boettcher function](README.md#series-expansion-formula-of-the-boettcher-function)
También se puede hacer manualmente: reemplazar espacios con signo de guión.
El ejemplo en vivo está here
No hay tal directiva en la especificación de Markdown. Lo siento.
Puede que este subproceso esté desactualizado, pero para crear enlaces de documentos internos en markdown en uso Github ...
(NOTA: #title en minúscula)
# Contents
- [Specification](#specification)
- [Dependencies Title](#dependencies-title)
## Specification
Example text blah. Example text blah. Example text blah. Example text blah.
Example text blah. Example text blah. Example text blah. Example text blah.
Example text blah. Example text blah. Example text blah. Example text blah.
Example text blah. Example text blah.
## Dependencies Title
Example text blah. Example text blah. Example text blah. Example text blah.
Example text blah. Example text blah. Example text blah. Example text blah.
Example text blah. Example text blah. Example text blah. Example text blah.
Example text blah. Example text blah.
Se hizo una buena pregunta, así que he editado mi respuesta;
Se puede hacer un enlace interno a cualquier tamaño de título usando - # , ## , ### , #### un ejemplo rápido a continuación ... https://github.com/aogilvie/markdownLinkTest
Usando kramdown, parece que esto funciona bien:
file#header
Veo que se ha mencionado que
README.md#series-expansion-formula-of-the-boettcher-function
funciona de manera eficiente, pero la primera podría ser una buena alternativa para elementos además de encabezados o bien encabezados con múltiples palabras.
sí, markdown hace esto pero necesita especificar el ancla de nombre <a name=''xyx''> .
un ejemplo completo,
esto crea el enlace
[tasks](#tasks)
más adelante en el documento, creará el ancla con nombre (como se llame).
<a name="tasks">
my tasks
</a>
Ten en cuenta que también puedes envolverlo alrededor del encabezado.
<a name="tasks">
### Agile tasks (created by developer)
</a>