Markdown: erst die Bedeutung ordnen, dann gestalten
Markdown eignet sich für Notizen und Dokumentation, weil der Quelltext lesbar bleibt. Entscheidend ist die Unterscheidung zwischen Überschriften, Absätzen und Listen, nicht die Menge der Formatierungszeichen.
Eine Überschrift ist mehr als eine Schriftgröße
Beginnen Sie mit dem Dokumentthema und ordnen Sie Abschnitte darunter ein. # und ## mit folgendem Leerzeichen bezeichnen unterschiedliche Ebenen. Jede Zeile zur Hauptüberschrift zu machen zerstört diese Hierarchie.
Listen passen zu einzelnen Punkten, Absätze erklären Zusammenhänge. Gestaltung soll klare Sätze unterstützen, nicht ersetzen.
Quellen: CommonMark 0.31.2 — Structured text, headings and rendering differences
Die Vorschau ist nicht jede Veröffentlichungsumgebung
Markdown-Erweiterungen unterscheiden sich. Eine Tabelle in einem Editor garantiert kein gleiches Ergebnis in einem anderen System. Prüfen Sie die tatsächliche Leseumgebung.
ToolRoof zeigt HTML an und exportiert es, führt eingegebenes Roh-HTML jedoch nicht aus. Externe Bilder erscheinen als Beschreibungen, Links sind in der Vorschau inaktiv. Ganze Webseiten werden nicht nachgebildet.
Quellen: CommonMark 0.31.2 — Structured text, headings and rendering differences
Die Quelle neben der Ausgabe aufbewahren
Markdown-Quellen erleichtern den Vergleich späterer Änderungen. HTML dient der Darstellung; eine Rückkonvertierung muss den ursprünglichen Quelltext nicht exakt wiederherstellen.
Prüfen Sie Inhalte und Links vor dem Teilen. Eine Vorschau bestätigt weder Fakten noch die Sicherheit verlinkter Seiten und erteilt keine Rechte zur Wiederverwendung fremder Inhalte.
Beispiel: eine kurze Besprechungsnotiz
Schreiben Sie # Wochenplan, danach ## Prioritäten und auf getrennten Zeilen - Zusammenfassung prüfen sowie - Entwurf senden. Das ergibt Hauptüberschrift, Unterüberschrift und 2 Listenpunkte statt 4 gleichartiger Absätze.
#Wochenplan ohne Leerzeichen ist keine ATX-Überschrift. Code zwischen Backticks bleibt angezeigter Text: Die Vorschau führt ihn nicht aus und beweist nicht seine Richtigkeit.