Markdown -Tabelle des Inhalts
Erstellen von Inhaltsverzeichnissen in Markdown:
Eine Inhaltstabelle kann in einem Dokument mit der nativen Markdown -Syntax erstellt werden. Dieses Tutorial hilft uns dabei, die Generierung der Inhaltstabelle zu lernen.
Für die praktische Implementierung der Markdown -Skripte benötigen wir ein Tool, das die Markdown -Sprache unterstützt. Wir haben den Visual Studio -Code für die Kompilierung von Beispielcodes ausgewählt. Nach dem Start des Tools haben wir eine neue Datei erstellt und ihren Typ auf „Markdown“ gesetzt.Um das Vorschau -Fenster zu öffnen, drücken Sie einfach die Tasten „Strg+Shift+V“. Jetzt haben wir eine "Markdown" -Datei und ein Vorschau -Fenster, das ihnen entspricht.
Das Werkzeug zum Kompilieren des Skripts ist jetzt festgelegt. Die Schaffung der Inhaltstabelle würde danach beginnen. In der Markdown -Datei haben wir zuerst einen Header erstellt. Für die Erstellung eines Headers müssen wir ein Hash (#) -Symbol hinzufügen. Das Hinzufügen eines einzelnen Hashs (#) bezieht sich auf die erste Ebene der Stufe. Nach dem Hash -Symbol muss vor dem Schreiben des Textes Ihres Headers ein Raum gegeben werden. Der Text, den wir für den Header unseres Dokuments angegeben haben.Dies erzeugt eine Überschrift mit H1 -Größe oben auf unserer Webseite.
Dann haben wir einige Zeilen übersprungen, bevor wir das nächste Skript geschrieben haben. Jetzt erstellen wir eine Liste der im Dokument verfügbaren Inhaltsverschiebungen. Für das Erstellen einer Markdown -Liste haben wir zwei Möglichkeiten: Ob Sie geordnete Listen oder nicht ordnungsgemäße Listen erstellen sollen. Für die Listengenerierung müssen wir einen numerischen Wert schreiben und einen Punkt hinzufügen (.) unmittelbar danach. Erwähnen Sie nach einem Raum die Listenelemente. Für die Listenelemente hier müssen wir Markdown -Links erstellen, die uns zu einem bestimmten Abschnitt des Dokuments lenken, wenn wir darauf klicken.
Wir haben also das erste Listenelement mit dem numerischen Wert "1" hinzugefügt und dann den Link zu einem Abschnitt der Seite erstellt, haben wir zuerst den Übergangstitel innerhalb der Quadratklammern geschrieben, gefolgt von runden Zahnspangen, die einen Hash enthalten (#). Symbol und der Titel des Übergangs, auf den er den Benutzer lenken kann. Sie können in den runden Klammern keine Registerkarte oder Platz angeben, wenn Sie Links zu einem Teil des Dokuments hinzufügen. Stattdessen können Sie die Striche (-) verwenden, wo immer sie als Ersatz für Räume benötigt werden. Für das erste Listenelement haben wir den Link als „1“ hinzugefügt. [Einführung] (#Einführung).”
Der Text in der quadratischen Klammer wird so angezeigt, dass er auf ihn klickt, und scroll. Das zweite Listenelement ist als „2) beigefügt. [Thema 1] (#Thema-1)."Hier wird" Thema 1 "so gerendert, wie es ist und das"#topic-1 "als Abschnittslink eingebettet wird. Das dritte Listenelement hat den Text „3. [Thema 2] (#Thema-2).Und der letzte Artikel hat es als „4. [Thema 3] (#Thema-3).”
Jetzt würden wir Unterwegs mit demselben Titel erstellen, wie im Listenabschnitt Link erwähnt. Um die Unterblätter zu erstellen, müssen wir Doppel -Hashes verwenden (##). Setzen Sie nach den Symbolen einen Platz ein und schreiben Sie dann den Überschriftentitel ein, der die gleichen sein sollte wie für den Link in der obigen Liste. Wenn wir einen anderen Titel hinzufügen, funktioniert der Link nicht. Also haben wir die erste Unterschrift hinzugefügt, nachdem wir den Hashes als „Einführung eingesetzt hatten."Für die zweiten, dritten und vierten Überschriften sind die Titel" Thema 1 "," Thema 2 "bzw." Thema 3 ".
Das Vorschau -Fenster zeigt uns das entsprechende erwartete Ergebnis für dieses Markdown -Skript an, in dem ein Inhaltsverzeichnis mit 4 Listenelementen generiert wird und ihre Referenzüberschriften unten angezeigt wurden.
All dies sind Textinhalte. Wir können auch einen externen Link als Überschrift in der Inhaltstabelle hinzufügen. Wir werden dem gleichen Muster folgen, das wir in der vorherigen Listenelementerstellung verwendet haben, mit Ausnahme einer Sache. Wir werden einen Link zur Website mit dem Abschnittslink auch in den runden Klammern hinzufügen. Dafür haben wir zuerst ein weiteres Listenelement als „5) erstellt. [Thema 4] (#Thema-5HTTPWWWYAHOOCOM).Sie können sehen, dass wir keine Punkte im Website -Namen hinzugefügt haben.
Jetzt müssen wir eine Überschrift erstellen, die diesem Link entspricht. Also haben wir Doppel -Hashes und Raum hinzugefügt, und dann werden wir hier nicht einfach den Text für den Titel schreiben. Stattdessen erstellen wir einen Link. Zunächst schreiben wir den Linktext, den wir für das neue Listenelement angegeben haben. „[Thema 5].Dann haben wir sofort nach den quadratischen Klammern runde Klammern eingefügt und den vollständigen Website -Link als „http: // www geschrieben.Yahoo.com ”.
Dies fügt dem Inhaltsverzeichnis einen weiteren Übergang hinzu, aber es ist ein Link, nicht nur ein einfacher Text.
Sie können sehen, dass die letzte Überschrift unterstrichen wurde, was darstellt, dass es sich um einen Link handelt. Wenn wir darauf klicken, wird die angegebene Webadresse im Browser geöffnet. Hier haben wir das „Yahoo“ zur Verfügung gestellt.com ”. Also wird es Yahoo in unserem Browser öffnen.
Wir haben unsere Inhaltsverzeichnis Tabelle im Markdown erfolgreich generiert, das einige Überschriften und eine Liste enthält. Jetzt werden wir sehen, wie wir den Hauptüberschriften der Liste Unterschreitungen hinzufügen können.
Aus der zuvor generierten Inhaltsliste haben wir die 2 ausgewähltnd Listenelement mit dem Titel "Thema 1" enthält. Um eine untergeordnete Liste zu erstellen, müssen wir zwei Leerzeichen in der Zeile neben dem Element der übergeordneten Liste eingeben. Nachdem wir die Räume angegeben hatten, haben wir die Liste als „1) nummeriert.Dann haben wir die Quadratklammern verwendet, um die Titel anzugeben, gefolgt von runden Klammern, um einen Link zum spezifischen Teil des Dokuments zu liefern. Also haben wir zwei Kinderlistenelemente als „1“ hinzugefügt. [Sub-topic 1] (#sub-topic-1) ”und in der nächsten Zeile ist das zweite Element„ 2. [Sub-topic 2] (#sub-topic-2.) "
Wenn wir uns dann zum Inhaltsteil des Dokuments wechseln, haben wir zwei neue Unterheime hinzugefügt. Um Sub-Headings mit Stufe 3 zu erstellen, müssen wir 3 Hash (#) -Symbole hinzufügen, gefolgt von einem Raum und dem Text des Unterkopfs. Wir haben dieselben Titel angegeben, die wir zum Verknüpfen der Abschnitte in der Liste erwähnt haben. Die erste Unterschrift hat den Titel "Sub-Topic 1" und der zweite "Sub-Topic 2).”
In der Snapshot des folgenden Vorschauerfensters werden Sie feststellen.
Abschluss
Das Inhaltsverzeichnis (TOC) kann manuell in einem Markdokument -Dokument erzeugt werden. In diesem Leitfaden haben wir an der Fähigkeit von Markdown gearbeitet, die Erzeugung eines Inhaltsverzeichnisses manuell zu ermöglichen. Wir haben die Code -Snippets ausgeführt und auf allen verwendeten Syntax und Schritten ausgearbeitet, die ausgeführt werden müssen. Wir haben gelernt, ein einfaches Inhaltsverzeichnis mit einer Markdown -Liste und Überschriften zu erstellen. Auch das Einbetten externer Links in die Überschriften des Dokuments macht es für Sie umfassend.