Phenquestions
Der Standard-Markdown
Markdown ist ein von John Gruber entwickelter Standard. Das Hauptziel von Markdown ist es, die Datei auch in reinem Text lesbar zu machen. Wenn Sie in einem Nur-Text-Editor suchen möchten, sollten Sie es leicht haben, ihn zu lesen. Dies ist sehr hilfreich für Benutzer von vim und ähnlichem. Beachten Sie, dass dies ein Standard zum Ändern von Textdateien ist. Es ersetzt kein HTML. Stattdessen verwenden Sie es, um HTML zu erstellen, wo es nützlich ist. Im Fall von GitHub formatieren sie die Readme-Datei auf der Site. Solange Sie sich an den Standard halten, können Sie sicher sein, dass es gut aussieht.
Da GitHub nur ein paar Erweiterungen hinzugefügt hat, sollten Sie mit einem Markdown-Cheatsheet beginnen und von dort aus fortfahren. Hier ist eine Liste der gängigsten.
| Abschlag | Erweiterungen | Ergebnis |
| # (1 pro Stufe) | Überschriften | |
| * | Kursivschrift | |
| ** | Fett gedruckt | |
| > | Blockzitat | |
| 1. (usw.) | Bestellliste | |
| - | Ungeordnete Liste | |
| 'Code' | Dein Code | |
| „' | Md-ext | Codeblock starten und beenden |
| - | Horizontale Regel | |
| [Beschreibung](https://www.Beispiel.com) | Ein Name in Quadrat und eine URL in regelmäßigen Klammern | |
|  | Gleiches, Link zu einem Bild | |
| [1] | Md-ext | Eine Fußnote |
Die Listen können verschachtelt werden, indem Sie alle Elemente einrücken, die Sie verschachteln möchten.
Andere Erweiterungen zu regulärem Markdown, Sie haben die Codeblock-Erweiterungen oben. Sie werden nicht immer von Diensten unterstützt.
| Abschlag | Erweiterungen | Ergebnis |
| ### Überschrift #custom-id | Md-ext | Eine Überschrift, die Sie anhand ihrer ID ansprechen können |
| Begriff: Definition | Md-ext | Eine Liste von Begriffen mit Definitionen |
| ~Falscher Text~ | Md-ext | Durchgestrichener Text |
| - [x] Aufgabe zu erledigen | Md-ext | Eine Aufgabenliste zum Abhaken |
Die Tabelle ist sehr einfach, aber Sie benötigen mehrere Zeilen, um sie anzuzeigen: Tabelle:
| Name | WERT|| ------------ | ---------- |
| Matten | 100 |
GitHub-Erweiterungen.
GitHub hat einige Erweiterungen hinzugefügt, um die Handhabung von Links zu anderen Personen und Projekten zu vereinfachen. Einige davon sind die bereits erwähnten Tabellen. Diejenige, die Ihnen am meisten hilft, ist die Auto-Link-Erweiterung. Es erstellt einen eigenen Link, wenn Sie es auf GitHub verwenden.
Andere sind Tabellen und Aufgabenlistenelemente. Diese sind praktisch, um Ihre Aufgaben in Projekten zu verfolgen. Als letztes ist die Disallowed Raw HTML-Erweiterung zu erwähnen. Mithilfe dieser Erweiterung werden einige Tags beim Rendern für HTML gefiltert. Diese Tags können beim Rendern auf GitHub seltsame Effekte verursachen.
Möglichkeiten, GitHub Markdown zu erkunden
Wenn Sie es verwirrend finden, können Sie auch auf die GitHub-Seite gehen und den integrierten Editor verwenden. Wenn Sie es verwenden, werden einige Funktionen automatisch ausgeführt. Dies funktioniert nur bei Problemen, aber Sie können es verwenden, um einige Dinge herauszufinden. Die Emojis werden als Liste angezeigt, wenn Sie einen Doppelpunkt eingeben (:).
Sie können auch auf GitHub ein Projekt mit einer großartig aussehenden README-Datei finden und auf Ihr lokales Laufwerk klonen. Von dort aus können Sie die Datei mit einem beliebigen Editor erkunden. Für die großen Editoren Emacs und Vim gibt es Unterstützung für Markdown durch Erweiterungen.
Wenn Sie vim verwenden, können Sie eine Syntax-Highlighting-Erweiterung von GitHub einfügen, vim-markdown. Diese Erweiterung zeigt Ihnen, dass Sie den Code richtig gemacht haben. Damit Sie sehen können, wie es aussieht, wenn es fertig ist, können Sie auch die Live-Markierungserweiterung erhalten. Damit können Sie einen Webserver laufen lassen, der das Ergebnis live während der Eingabe anzeigt.
Mit Emacs haben Sie Ungeduldig-Modus, Live-Down-Modus und Echtzeit-Vorschau. Sie alle zeigen Ihre resultierende Seite in einem Browser, während Sie tippen. Ersteres erfordert weniger Bibliotheken als letzteres, benötigt jedoch einen zusätzlichen Code-Snippet zum Ausführen.
Fazit
Auch wenn der Markdown eine kleine und bewusst einfache Spezifikation ist, kann der Anfang etwas verwirrend sein. Der beste Weg, um zu lernen, ist, einen Spickzettel zu verwenden und Ihr Markdown-Dokument zu schreiben. Sie können Ihre README-Datei aktualisieren.md auf GitHub, und Sie können viel Unterstützung von den integrierten Funktionen Ihrer Editoren erhalten. Als Randnotiz unterstützt GitHub auch Emojis, die Sie Ihrem Dokument hinzufügen können. Sie können den Spickzettel verwenden, um herauszufinden, welche es sind.
Markdown-CheatSheetHier herunterladen
