Comment créer un lien vers une partie du même document dans Markdown?

Question

J’ai écris un long document Markdown et voudrais placer une table des matières de toutes sortes au début qui fournira des liens à de divers emplacements dans le document. Comment est-ce que je peux faire cela ?

J’ai essayé d’utiliser

où `` est un titre dans le document et cela n’a pas fonctionné.

Answer 1

GitHub analyse automatiquement les balises d’ancrage vos en-têtes. Si vous pouvez faire ce qui suit :

Dans le cas ci-dessus, l’en-tête « Foo » a généré une balise d’ancrage avec le nom « foo ». Remarque : les noms de balises d’ancrage sont minuscules et qui est délimitée par des tirets si plusieurs mots.

Answer 2

Cela peut être out-of-date de fil, mais pour créer intérieure liens vers des documents en markdown dans Github utiliser...
(NOTE: en minuscules #titre)

    # 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. 

Une bonne question a fait en sorte que j'ai édité ma réponse;

Intérieure d'un lien peut être fait à n'importe quel titre la taille à l'aide - #, ##, ###, #### J'ai créé un petit exemple ci-dessous... https://github.com/aogilvie/markdownLinkTest

Answer 3

L'expérimentation, j'ai trouvé une solution en utilisant <div…/> mais une solution évidente est de placer votre propre point d'ancrage dans la page où vous le souhaitez, donc:

<a name="abcde"/>

avant la ligne que vous voulez "lien". N'oubliez pas les guillemets autour d'elle. Puis un abattement lien du type:

[link text](#abcde)

n'importe où dans le document, vous y amène.

L' <div…/> solution insère un "dummy" de la division juste pour ajouter l' id de la propriété, et c'est potentiellement perturbateurs de la structure de la page, mais l' <a name="abcde"/> solution devrait être tout à fait inoffensif.

(PS: Il est peut-être OK pour mettre l'ancre dans la ligne vous souhaitez faire un lien, comme suit:

## <a name="head1"/>Heading One

mais cela dépend de la façon dont Markdown traite ce. Je note, par exemple, le Dépassement de Pile réponse formateur est heureux avec cela!)

Answer 4

Dans pandoc, si vous utilisez l'option --toc dans la production de html, une table des matières qui seront produits avec des liens vers les sections, et retour à la table des matières à partir des titres de section. Il est similaire avec les autres formats de pandoc écrit, comme le LaTeX, rtf, tvd, etc. Donc, avec la commande

pandoc --toc happiness.txt -o happiness.html

ce bit de markdown:

% 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.

donnera ce que le corps du 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>

Answer 5

Il n’y a aucune de ces directives dans la spec de Markdown. Désolé.