Was ist in Markdown der beste Weg, um auf ein Fragment einer Seite zu verlinken, dh #some_id?

Ich versuche herauszufinden, wie ich mit Markdown auf einen anderen Bereich einer Seite verweisen kann. Ich kann es zum Laufen bringen, wenn ich a hinzufüge

<div id="mylink" /> 

und für den Link tun:

[My link](#mylink)

Ich vermute jedoch, dass es in Markdown eine andere Möglichkeit gibt, einen In-Page-Link zu erstellen, bei dem das Straight-Up- divTag nicht verwendet wird.

Irgendwelche Ideen?

Siehe diese Antwort .

Zusammenfassend machen Sie ein Ziel mit

<a name="sometext"></a>

an einer beliebigen Stelle in Ihrem Markdown-Markup eingefügt (z. B. in einer Kopfzeile:

## heading<a name="headin"></a>

und über die Markdown-Verknüpfung darauf verlinken:

[This is the link text](#headin)

oder

[some text](#sometext)

Nicht verwenden <div>- dies wird das Layout für viele Renderer durcheinander bringen.

(Ich habe id=zu name=oben gewechselt . Siehe diese Antwort für die mühsame Erklärung.)

Ich denke, das hängt davon ab, was Sie verwenden, um HTML aus Ihrem Markdown zu generieren. Mir ist aufgefallen, dass jekyll (standardmäßig von gihub.io-Seiten verwendet) automatisch das Attribut id = "" zu Überschriften in dem von ihm generierten HTML hinzufügt.

Zum Beispiel, wenn Sie Abschlag sind

My header
---------

Das resultierende HTML sieht folgendermaßen aus:

<h2 id="my-header">My header</h2>

Sie können also einfach über darauf verlinken [My link](#my-header)

Mit der PHP-Version von Markdown können Sie Header auch mit Fragmentkennungen innerhalb der Seite verknüpfen, indem Sie eine Syntax wie eine der folgenden verwenden, wie hier dokumentiert

Header 1            {#header1}
========

## Header 2 ##      {#header2}

und dann

[Link back to header 1](#header1)
[Link back to header 2](#header2)

Leider wird diese Syntax derzeit nur für Header unterstützt, könnte aber zumindest zum Erstellen eines Inhaltsverzeichnisses hilfreich sein.

Der Zielanker für einen Link in einer HTML-Seite kann ein beliebiges Element mit einem idAttribut sein. Siehe Links auf der W3C-Site. Hier ist ein Zitat aus dem entsprechenden Abschnitt:

Zielanker in HTML-Dokumenten können entweder durch das A-Element (Benennung mit dem Attribut name) oder durch ein anderes Element (Benennung mit dem Attribut id) angegeben werden.

Markdown behandelt HTML als HTML (siehe Inline-HTML ), sodass Sie Ihre Fragment-IDs aus einem beliebigen Element erstellen können. Wenn Sie beispielsweise einen Link zu einem Absatz erstellen möchten, schließen Sie den Absatz einfach in ein Absatz-Tag ein und geben Sie eine ID ein:

<p id="mylink">Lorem ipsum dolor sit amet...</p>

Verwenden Sie dann Ihren Standard-Markdown [My link](#mylink), um einen Link zum Fragmentanker zu erstellen. Dies hilft dabei, Ihr HTML sauber zu halten, da kein zusätzliches Markup erforderlich ist.

Für jeden, der Visual Studio Team Foundation Server (TFS) 2015 verwendet, sind eingebettete Elemente <a>oder <div>Elemente zumindest in Kopfzeilen nicht besonders beliebt. Es mag auch kein Emoji in Headern:

### 🔧 Configuration 🔧

Lorem ipsum problem fixem.

Wird übersetzt nach:

<h3 id="-configuration-">🔧 Configuration 🔧</h3>
<p>Lorem ipsum problem fixem.</p>

Daher sollten Links entweder das verwenden id(wodurch diese und andere Vorschauerweiterungen in Visual Studio beschädigt werden) oder das Emoji entfernen:

Here's [how to setup](#-configuration-) //🔧 Configuration 🔧
Here's [how to setup](#configuration) //Configuration

Wo die letztere Version sowohl online in TFS als auch in der Markdown-Vorschau von Visual Studio funktioniert .