J'ai rencontré un certain nombre de mentions de la prise en charge de MultiMarkdown pour les liens internes / ancres nommées, mais je ne parviens pas à trouver un seul exemple de la façon de le faire.
Alors, quelle est la syntaxe pour désigner l'ancre nommée, et quelle est la syntaxe pour y lier la même chose que pour un lien vers d'autres URL (en utilisant uniquement #foo au lieu de http://....
)?
markdown
multimarkdown
masukomi
la source
la source
Réponses:
Dans Markdown standard, placez une ancre à l'
<a name="abcd"></a>
endroit où vous souhaitez créer un lien et faites-y référence sur la même page par[link text](#abcd)
.(Cela utilise
name=
et nonid=
, pour les raisons expliquées dans cette réponse .)Les références à distance peuvent
[link text](http://...#abcd)
bien sûr utiliser .Cela fonctionne comme un rêve, à condition que vous ayez le contrôle sur les textes source et cible. L'ancre peut même apparaître dans un en-tête, donc:
produit:
Un titre dans cette entrée SO!
et nous pouvons même créer un lien vers celui-ci:
(Sous SO, le lien ne fonctionne pas car l'ancre est supprimée.)
la source
<a id="id"></a>
forme est la meilleure. Voir cette question / réponse SO .name=
été déconseillé en XHTML, mais maintenant je trouve que celaid=
a un effet secondaire en HTML5, donc je reviens àname=
cette réponse.Si vous avez des en-têtes dans les fichiers de démarque, vous pouvez les lier directement dans le fichier.
En-tête de démarque -
## The Header
cela générera un identifiant implicite
#the-header
(remplacez les espaces internes par des tirets et réduisez les minuscules).Pour accéder à cet identifiant, vous pouvez créer le lien comme ceci:
[Link to Header](#the-header)
Cela équivaut à:
<a href="#the-header">Link to Header</a>
Veuillez noter que le nom de la référence est en minuscule
#header
.la source
## This Header ##
, le lien serait[To This Header](#markdown-header-this-header)
. Si vous n'êtes pas sûr de l'ID de votre en-tête, utilisez un inspecteur de page pour voir les valeurs HTML.[Link](user-content-the-header)
Tiré du Guide de l'utilisateur de Multimarkdown (merci à @MultiMarkdown sur Twitter de l'avoir signalé)
[Some Text][]
sera lié à un en-tête nommé «Some Text»,par exemple
Une étiquette facultative de votre choix pour aider à lever l'ambiguïté lorsque plusieurs en-têtes ont le même titre:
la source
J'ai testé Github Flavored Markdown pendant un certain temps et je peux résumer avec quatre règles:
-
Par exemple, si votre section est nommée ceci:
Créez un lien vers celui-ci de cette façon:
la source
La meilleure façon de créer des liens internes (liés aux sections) est de créer une liste mais au lieu de lien, mettez #section ou # section-title si l'en-tête comprend des espaces.
---- REMBOURSEMENT ------------------------
---- APERÇU DE LA LISTE ------------------------
---- HTML ------------------------
Peu importe que ce soit l'en-tête h1, h2, h3, etc., vous vous y référez toujours en utilisant un seul
#
.Toutes les références dans la liste des sections doivent être converties en texte en minuscules, comme indiqué dans l'exemple ci-dessus.
Le lien vers la section doit être en minuscules. Sinon, cela ne fonctionnera pas.
Cette technique fonctionne très bien pour toutes les variantes de Markdown, également MultiMarkdown.
Actuellement, j'utilise Pandoc pour convertir le format des documents. C'est beaucoup mieux que MultiMarkdown.
Testez Pandoc ici
la source
## Hello
vous devez vous y référer comme[Whatever you want](#Hello)
Dans mdcharm, c'est comme ça:
la source
Voici ma solution (dérivée de
SaraubhM
la réponse de)**Jump To**: [Hotkeys & Markers](#hotkeys-markers) / [Radii](#radii) / [Route Wizard 2.0](#route-wizard-2-0)
Ce qui vous donne:
Aller à : Raccourcis clavier et marqueurs / Radii / Route Wizard 2.0
Notez les changements de
et
.
vers-
et aussi la perte de&
dans les liens.la source