Thorsten: Die Seite wurde neu angelegt: „NOTOC Der '''Markdown-Lernpfad''' bringt erfahrene Entwicklerinnen und Entwickler Schritt für Schritt dazu, '''Markdown''' nicht mehr „aus dem Bauch heraus", sondern wirklich zu verstehen – CommonMark-Grundsyntax, GitHub Flavored Markdown (GFM), Frontmatter-Konventionen für Static-Site-Generatoren und Team-Tooling (`markdownlint`, Prettier, Keep a Changelog, GitHub-Vorlagen). Anders als die übrigen Geschwisterbücher ist dieses Buch an '''keine…“

2026-09-13T02:22:33Z

Die Seite wurde neu angelegt: „__NOTOC__ Der '''Markdown-Lernpfad''' bringt erfahrene Entwicklerinnen und Entwickler Schritt für Schritt dazu, '''Markdown''' nicht mehr „aus dem Bauch heraus", sondern wirklich zu verstehen – CommonMark-Grundsyntax, GitHub Flavored Markdown (GFM), Frontmatter-Konventionen für Static-Site-Generatoren und Team-Tooling (`markdownlint`, Prettier, Keep a Changelog, GitHub-Vorlagen). Anders als die übrigen Geschwisterbücher ist dieses Buch an '''keine…“

Neue Seite

__NOTOC__
Der '''Markdown-Lernpfad''' bringt erfahrene Entwicklerinnen und Entwickler Schritt für Schritt dazu, '''Markdown''' nicht mehr „aus dem Bauch heraus", sondern wirklich zu verstehen – CommonMark-Grundsyntax, GitHub Flavored Markdown (GFM), Frontmatter-Konventionen für Static-Site-Generatoren und Team-Tooling (`markdownlint`, Prettier, Keep a Changelog, GitHub-Vorlagen). Anders als die übrigen Geschwisterbücher ist dieses Buch an '''keinen''' Editor und an '''kein''' KI-Werkzeug gebunden – jede Übung funktioniert in jedem Texteditor und direkt im Browser. Durchgehendes Projekt ist wieder '''Harborlight''' und Team '''Driftline''', mit '''Priya Nair''' (Tech Lead) als Hauptfigur, die uneinheitliche Dokumentation im Team konsistent machen will.

== Der Lernpfad in vier Stufen ==

=== 🟢 L1 – Grundlagen: Markdown lesen und schreiben, wie es gemeint ist ===

Blocksyntax-Grundprinzip, Überschriften, Betonung, Escaping, Listen, Links, Bilder, Codeblöcke.

{| class="wikitable"
|-
! Nr. !! Kapitel !! Das lernst du !! Status
|-
| 1 || [[Markdown/Warum Markdown lernen, obwohl man's "schon kennt"|Warum Markdown lernen, obwohl man's "schon kennt"]]
| CommonMark vs. GitHub Flavored Markdown, warum „ein" Markdown nicht existiert || –
|-
| 2 || [[Markdown/Blocksyntax: Absätze und Überschriften|Blocksyntax: Absätze und Überschriften]]
| Leerzeile trennt Blöcke, weicher vs. erzwungener Umbruch, ATX vs. Setext || –
|-
| 3 || [[Markdown/Betonung und Escaping|Betonung und Escaping]]
| `_` respektiert Wortgrenzen, `*` nicht; Sonderzeichen per Backslash escapen || –
|-
| 4 || [[Markdown/Listen|Listen]]
| Verschachtelung über relative Einrückung, straffe vs. lose Listen || –
|-
| 5 || [[Markdown/Links und Bilder|Links und Bilder]]
| Inline- vs. Referenzstil, Alt-Text als Pflicht, nicht als Kür || –
|-
| 6 || [[Markdown/Codeblöcke|Codeblöcke]]
| Inline-Code, indentierte vs. eingezäunte Codeblöcke, Sprachangabe || –
|}

=== 🟡 L2 – Fortgeschritten: GitHub Flavored Markdown und Rendering-Unterschiede ===

Tabellen, Blockquotes, GFM-Erweiterungen, eingebettetes HTML, Renderer-Vergleich, Frontmatter.

{| class="wikitable"
|-
! Nr. !! Kapitel !! Das lernst du !! Status
|-
| 7 || [[Markdown/Tabellen|Tabellen]]
| GFM-Syntax, Ausrichtung, Pipe-Escaping – Ursache für mdBooks „unclosed HTML tag" || –
|-
| 8 || [[Markdown/Blockquotes|Blockquotes]]
| Verschachtelung mit `>`, „lazy continuation" vs. explizite Markierung || –
|-
| 9 || [[Markdown/GFM-Erweiterungen: Task Lists, Strikethrough, Autolinks|GFM-Erweiterungen: Task Lists, Strikethrough, Autolinks]]
| `- [ ]`/`- [x]`, `~~Text~~`, automatische URL-Verlinkung || –
|-
| 10 || [[Markdown/Eingebettetes HTML|Eingebettetes HTML]]
| CommonMark reicht HTML durch, GitHub sanitisiert aus Sicherheitsgründen || –
|-
| 11 || [[Markdown/CommonMark vs. GFM vs. mdBook|CommonMark vs. GFM vs. mdBook]]
| Spezifikation ist nicht Implementierung, am eigenen Buch demonstriert || –
|-
| 12 || [[Markdown/Frontmatter|Frontmatter]]
| YAML-Metadaten für Jekyll/Hugo und GitHub-Issue-Vorlagen – kein mdBook-Feature || –
|}

=== 🟠 L3 – Profi: Konsistenz und Team-Tooling ===

`markdownlint`, Prettier, CHANGELOG.md, GitHub-PR-/Issue-Vorlagen.

{| class="wikitable"
|-
! Nr. !! Kapitel !! Das lernst du !! Status
|-
| 13 || [[Markdown/markdownlint|markdownlint]]
| `markdownlint-cli2`, benannte Regeln, bewusste Ausnahmen dokumentieren || –
|-
| 14 || [[Markdown/Automatisch formatieren mit Prettier|Automatisch formatieren mit Prettier]]
| `proseWrap`, warum Formatierer und Linter sich ergänzen statt konkurrieren || –
|-
| 15 || [[Markdown/CHANGELOG.md nach Keep a Changelog|CHANGELOG.md nach Keep a Changelog]]
| Nutzerperspektive statt Commit-Historie, `Unreleased`, sechs Kategorien || –
|-
| 16 || [[Markdown/GitHub-Vorlagen: PR- und Issue-Templates|GitHub-Vorlagen: PR- und Issue-Templates]]
| `.github/PULL_REQUEST_TEMPLATE.md`, `.github/ISSUE_TEMPLATE/`, Issue Forms || –
|}

=== 🔴 L4 – Ausblick, Grenzen ===

Ehrliche Grenzen von Markdown als Format.

{| class="wikitable"
|-
! Nr. !! Kapitel !! Das lernst du !! Status
|-
| 17 || [[Markdown/Grenzen von Markdown und Ausblick|Grenzen von Markdown und Ausblick]]
| Keine Include-Logik, uneinheitliche Erweiterungen, wann ein anderes Werkzeug passt || –
|}

Portal:Markdown - Versionsgeschichte