pagina - ¿Cómo enlazar a un ancla con nombre en Multimarkdown?
cómo se hace un ancla en html (7)
Aquí está mi solución (derivada de la de )
**Jump To**: [Hotkeys & Markers](#hotkeys-markers) / [Radii](#radii) / [Route Wizard 2.0](#route-wizard-2-0)
Lo que te da:
Saltar a : Hotkeys & Markers / Radii / Route Wizard 2.0
Tenga en cuenta los cambios de y
.
a -
y también la pérdida del &
en los enlaces.
Me he topado con una serie de menciones del soporte de MultiMarkdown para enlaces internos / anclajes con nombre, pero no puedo encontrar un solo ejemplo de cómo hacerlo realmente.
Entonces, ¿cuál es la sintaxis para denotar el anclaje nombrado, y cuál es la sintaxis para vincularlo igual que para vincular a cualquier otra URL (solo usando #foo en lugar de http://....
)?
En Markdown estándar, coloque un ancla <a name="abcd"></a>
donde desee vincularlo y consúltelo en la misma página con [link text](#abcd)
.
(Esto usa name=
y no id=
, por las razones explicadas en esta respuesta ).
Las referencias remotas pueden usar [link text](http://...#abcd)
por supuesto.
Esto funciona como un sueño, siempre que tenga control sobre los textos de origen y destino. El ancla puede incluso aparecer en un encabezado, así:
### <a name="head1234"></a>A Heading in this SO entry!
produce:
Un título en esta entrada de SO!
e incluso podemos enlazar a ella así:
and we can even [link](#head1234) to it so:
(En SO, el enlace no funciona porque se quita el ancla).
En mdcharm es así:
* [Descripción](#descripcion)
* [Funcionamiento](#funcionamiento)
* [Instalación](#instalacion)
* [Configuración](#configuracion)
### Descripción {#descripcion}
### Funcionamiento {#funcionamiento}
### Instalación {#instalacion}
### Configuración {#configuracion}
La mejor manera de crear enlaces internos (relacionados con las secciones) es crear una lista, pero en lugar de un enlace, coloque # sección o # sección-título si el encabezado incluye espacios.
---- MARKDOWN ------------------------
Go to section
* [Hello](#hello)
* [Hello World](#hello-world)
* [Another section](#new-section) <-- it''s called ''Another section'' in this list but refers to ''New section''
## Hello
### Hello World
## New section
---- vista previa de la lista ------------------------
Go to section
Hello <-- [Hello](#hello) -- go to `Hello` section
Hello World <-- [Hello World](#hello world) -- go to `Hello World` section
Another section <-- [Another section](#new-section) -- go to `New section`
---- HTML --------------------------
<p>Go to section</p>
<ul>
<li><a href="#hello">Hello</a><br />
</li>
<li><a href="#hello-world">Hello World</a></li>
<li><a href="#new-section">Another section</a> <– it’s called ‘Another section’ in this list but refers to ‘New section’</li>
</ul>
<h2 id="hello">Hello</h2>
<h3 id="hello-world">Hello World</h3>
<h2 id="new-section">New section</h2>
No importa si se trata de un encabezado h1, h2, h3, etc., siempre hace referencia a él usando solo un #
.
Todas las referencias en la lista de secciones se deben convertir a texto en minúsculas como se muestra en el ejemplo anterior.
El enlace a la sección debe estar en minúsculas. De otra manera no funcionará.
Esta técnica funciona muy bien para todas las variantes de Markdown, también MultiMarkdown.
Actualmente estoy usando el Pandoc para convertir documentos en formato. Es mucho mejor que MultiMarkdown.
Prueba Pandoc aquí
Si tiene encabezados en los archivos de rebajas, puede vincularlos directamente en el archivo.
Encabezado de Markdown -
## The Header
esto generará un id implícito #the-header
(reemplace los espacios internos con guiones y haga minúsculas).
Para navegar a este ID, puede crear el enlace de esta manera:
[Link to Header](#the-header)
Esto es equivalente a:
<a href="/current_url#the-header">Link to Header</a>
Tenga en cuenta que el nombre de la referencia es minúscula #header
.
Tomado de la Guía del usuario de Multimarkdown (gracias a @MultiMarkdown en Twitter por señalarlo)
[Some Text][]
se vinculará a un encabezado llamado "Algún texto"
p.ej
### Some Text ###
Una etiqueta opcional de su elección para ayudar a eliminar la ambigüedad de casos en los que múltiples encabezados tienen el mismo título:
### Overview [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.
Probé Github Flavored Markdown por un tiempo y puedo resumir con cuatro reglas:
- los signos de puntuación se caerán
- Los primeros espacios en blanco se dejarán caer.
- mayúscula se convertirá en inferior
- Los espacios entre letras se convertirán a
Por ejemplo, si su sección se llama así:
## 1.1 Hello World
Crea un enlace a este de esta manera:
[Link](#11-hello-world)