Me he encontrado con varias 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 ancla con nombre y cuál es la sintaxis para vincularlo de la misma manera que vincular a cualquier otra URL (solo usando #foo en lugar de http://....
)?
markdown
multimarkdown
masukomi
fuente
fuente
Respuestas:
En Markdown estándar, coloque un ancla
<a name="abcd"></a>
donde desee vincular y consulte en la misma página[link text](#abcd)
.(Esto usa
name=
y noid=
, 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 incluso puede aparecer en un encabezado, por lo tanto:
produce:
Un encabezado en esta entrada SO!
e incluso podemos vincularlo así:
(En SO, el enlace no funciona porque el ancla está despojado).
fuente
<a id="id"></a>
forma es la mejor. Vea esta pregunta / respuesta SO .name=
estaba en desuso en XHTML, pero ahora encuentro queid=
tiene un efecto secundario en HTML5, por lo que estoy volviendo aname=
esta respuesta.Si tiene encabezados en los archivos de descuento, puede vincularlos directamente en el archivo.
Encabezado de rebajas -
## The Header
esto generará una identificación implícita
#the-header
(reemplazar espacios internos con guiones y hacer minúsculas).Para navegar a esta identificación, puede crear el enlace de esta manera:
[Link to Header](#the-header)
Esto es equivalente a:
<a href="#the-header">Link to Header</a>
Tenga en cuenta que el nombre de la referencia es minúscula
#header
.fuente
## This Header ##
, el enlace sería[To This Header](#markdown-header-this-header)
. Si no está seguro de cuál es la identificación de su encabezado, use un inspector de página para ver los valores HTML.[Link](user-content-the-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",por ejemplo
Una etiqueta opcional de su elección para ayudar a desambiguar casos donde varios encabezados tienen el mismo título:
fuente
Probé Github de sabores Markdown por un tiempo y puedo resumir con cuatro reglas:
-
Por ejemplo, si su sección se llama así:
Crea un enlace de esta manera:
fuente
La mejor manera de crear enlaces internos (relacionados con las secciones) es crear una lista, pero en lugar de un enlace, coloque #section o # section-title si el encabezado incluye espacios.
---- MARKDOWN ------------------------
---- VISTA PREVIA DE LA LISTA ------------------------
---- HTML ------------------------
No importa si es un encabezado h1, h2, h3, etc., siempre se refiere a él usando solo uno
#
.Todas las referencias en la lista de secciones deben convertirse 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 Pandoc para convertir el formato de documentos. Es mucho mejor que MultiMarkdown.
Prueba Pandoc aquí
fuente
## Hello
debe referirse a él como[Whatever you want](#Hello)
En mdcharm es así:
fuente
Aquí está mi solución (derivada de
SaraubhM
la respuesta de)**Jump To**: [Hotkeys & Markers](#hotkeys-markers) / [Radii](#radii) / [Route Wizard 2.0](#route-wizard-2-0)
Lo que te da:
Saltar a : Teclas de acceso rápido y marcadores / Radii / Route Wizard 2.0
Tenga en cuenta los cambios desde
y
.
hacia-
y también la pérdida de&
en los enlaces.fuente