Praktischer Markdown-Spickzettel für teilbare Dokumente
Nutze diesen Markdown-Spickzettel für Überschriften, Listen, Links, Tabellen, Aufgaben und Code und vergleiche das gerenderte Beispiel.
Ein guter Spickzettel hilft beim Fertigstellen eines Dokuments, statt sämtliche Markdown-Dialekte abzufragen. Öffne beim Schreiben den Markdown-Spickzettel und prüfe mit diesem Leitfaden die Alltagssyntax und ihr sichtbares Ergebnis. Er behandelt häufige Dokumentbausteine; für Formeln und Diagramme brauchst du eigene Referenzen.
Das Beispiel verbindet Überschriften, Textstile, Liste, Zitat, Link, Tabelle und Aufgabe. Kopiere es vollständig, um ihr Zusammenspiel zu sehen, statt einzelne Zeichen isoliert zu testen.
# Markdown field guide
## Inline text
**Bold**, *emphasis*, and `inline code`.
## Lists
- First item
- Second item
> A short quotation.
[Documentation](https://spec.commonmark.org/current/)
| Item | State |
|:--|:--|
| Draft | Reviewed |
- [x] GFM task list
Der Bildexport zeigt die visuelle Hierarchie. Bewahre auch Markdown auf: Dort bleiben Text und Linkziele bearbeitbar, während PNG nur eine visuelle Kopie ist.
- Abschnitte: Auf
#,##und###folgt ein Leerzeichen. Sie kennzeichnen absteigende Überschriftenebenen. Wähle die Ebene nach der Dokumentstruktur und nicht nach der gewünschten Schriftgröße einer Karte. - Bedeutung im Text:
**bold**hebt einen Schlüsselbegriff stark hervor,*emphasis*setzt einen leichteren Akzent. Backticks schützen kurze Codebezeichner. Vermeide vollständig fett gesetzte Absätze. - Listen: Verwende
-für Aufzählungen, Zahlen mit Punkt und Leerzeichen für Schritte. Rücke Unterpunkte unter ihrem übergeordneten Punkt ein. Leerzeilen erleichtern die Kontrolle getrennter Blöcke im Quelltext. - Zitat: Beginne Zitatzeilen mit
>. Nenne bei fremden Aussagen die Quelle im Begleittext. - Links und Bilder:
[label](URL)erzeugt einen Link. Für ein Bild steht vor derselben Klammerstruktur ein Ausrufezeichen; der Text in eckigen Klammern beschreibt das Bild.
Tabellen, Aufgabenlisten und durchgestrichener Text sind GFM-Erweiterungen und nicht in jedem Markdown-Renderer verfügbar. Die CommonMark-Spezifikation und die GFM-Spezifikation trennen Kernregeln von Erweiterungen. Prüfe solche Funktionen am tatsächlichen Zielort.
Das zweite Beispiel ergänzt eine nummerierte Liste mit Unterpunkt, wörtliche Sternchen, eine Trennlinie und einen eingezäunten Codeblock. Der äußere Zaun aus vier Backticks erlaubt es, den inneren aus drei Backticks wörtlich zu zeigen.
### A smaller section
1. Review the draft
- Check the facts
2. Export the result
~~Old wording~~ and \*literal asterisks\*.
---
```javascript
console.log("Ready");
```
Die Sprachangabe hinter einem Codezaun hilft bei der Syntaxhervorhebung. Sie führt das Programm nicht aus und bestätigt auch nicht seine Korrektheit.
Füge das Dokument nach der Syntaxkontrolle in den Markdown-Konverter ein. Wähle eine Breite, bei der längste Zeile und Tabelle lesbar bleiben. Prüfe die heruntergeladene Datei zusätzlich zur Editorvorschau. Wichtige Links gehören in den Begleittext, weil ein Bild keine klickbaren Markdown-Links hat.
Halte den interaktiven Spickzettel bereit. Bei konkreten Problemen helfen häufige Markdown-Fehler; längere Beispiele und Codezäune behandelt der Codeblock-Leitfaden.