Überschriften sind das Rückgrat jedes Markdown-Dokumentes. Sie definieren die Struktur, ermöglichen die Navigation, beeinflussen die Zugänglichkeit und beeinflussen SEO. Dieser Leitfaden behandelt alles über Markdown Rubriken Syntax, Hierarchie-Regeln, Plattformunterschiede und bewährte Verfahren.
Syntax der Überschrift
Markdown Überschriften verwenden die # Symbol (ATX-Stil). Die Zahl der # Zeichen bestimmt die Rubrikstufe:
# Heading 1
## Heading 2
### Heading 3
#### Heading 4
##### Heading 5
###### Heading 6Es gibt auch den Setext-Stil (nur H1 und H2):
Heading 1
=========
Heading 2
---------ATX-Stil (#) ist bevorzugt es ist expliziter und funktioniert für alle sechs Ebenen.
Was jede Stufe bedeutet
| Niveaus | HTML Tag | Zweck und Zweck |
|---|---|---|
| H1 | <h1> | Titel der Seite oder des Dokuments |
| H2 | <h2> | Hauptabschnitt |
| H3 | <h3> | Unterabschnitt innerhalb von H2 |
| H4 | <h4> | Unterabschnitt innerhalb von H3 |
| H5 | <h5> | In der Praxis selten eingesetzt |
| H6 | <h6> | Fast nie gebraucht |
Die meisten Dokumente verwenden nur H1H3. H4H6 weist in der Regel darauf hin, dass die Dokumentstruktur zu tief ist.
H1: Einer pro Seite
Eine H1-Überschrift sollte exakt einmal pro Markdown-Dokument erscheinen. Sie repräsentiert den Titel des Dokuments oder das Hauptthema der Seite.
Das ist gut.
# How to Convert Word to MarkdownVermeiden Sie:
# Section One
...
# Section Two ← Don't use multiple H1sSuchmaschinen und Zugänglichkeitstools erwarten eine einzige H1 pro Seite. Mehrere H1 verwirren beide.
Regeln für die Rubrikhierarchie
Fahren Sie immer in Reihenfolge voran. Überspringen Sie keine Stufen:
Richtig:
# Document Title
## Section
### Subsection
#### DetailFalsch:
# Document Title
#### Jumped to H4 ← Skips H2 and H3Das Überspringen von Überschriftengrößen verstößt gegen die Dokumentengröße und verstößt gegen die WCAG-Richtlinien für die Barrierefreiheit.
Umwandlung von Word Überschriften in Markdown
Wenn Sie ein Word-Dokument mit WordToMD, Words eingebaute Überschriftstylen direkt abbilden:
| Word-Stil | Markdown Leistung |
|---|---|
| Rubrik 1 | # Heading |
| Rubrik 2 | ## Heading |
| Rubrik 3 | ### Heading |
| Normal + fett | **Bold text** (Keine Rubrik) |
Das häufigste Problem: Autoren greifen und vergrößern die Schriftgröße manuell anstatt den Heading-Stil anzuwenden. Dies erzeugt Text, der wie eine Überschrift in Word aussieht, aber in Markdown in einfachen fettigen Text umgewandelt wird. Sehen Sie Word zu Markdown Formatierungsleitfaden Wie man das beheben kann.
Titelkennzeichen und Ankerverbindungen
Die meisten Markdown-Prozessoren erzeugen automatisch IDs aus dem Titeltext:
## Getting StartedGeneratoren: <h2 id="getting-started">Getting Started</h2>
Sie können darauf verlinken:
See the [Getting Started section](#getting-started).Regeln für automatisch generierte IDs:
- Alle Buchstaben in Kleinbuchstaben
- Lücken durch Bindelzeichen ersetzen
- Spezielle Zeichen außer Bindelzeichen
Beispiele:
## API Reference→#api-reference## What's New?→#whats-new## Step 1: Install→#step-1-install
Inhaltsverzeichnisse
Für lange Dokumente erzeugen Sie einen TOC unter Verwendung von Ankerverknüpfungen für die Überschrift:
## Table of Contents
- [Installation](#installation)
- [Configuration](#configuration)
- [Basic Settings](#basic-settings)
- [Advanced Options](#advanced-options)
- [Usage](#usage)
- [FAQ](#faq)GitHub erzeugt automatisch eine TOC in der oberen linken Ecke jeder Markdown-Datei mit Überschriften.
SEO Überlegungen
Für Markdown, die in statischen Websites (Jekyll, Hugo, Astro) verwendet und im Web veröffentlicht werden:
- H1 = Titel der Seite Fügen Sie Ihr wichtigstes Schlüsselwort ein. Eine für jede Seite.
- H2s = Hauptabschnitte Natürlich sekundäre Schlüsselwörter einfügen
- H3s = Unterabschnitte Spezifischere Themen
- Halten Sie die Überschriften beschreibend Wie man Abhängigkeiten installiert Schlägen Installation
- Überschriften werden von Suchmaschinen indiziert lassen sich durchsuchen
Sehen Sie Word zum statischen Standortgenerator für die Veröffentlichung von Markdown-Dokumenten im Internet.
Zugänglichkeit
Bildschirmleser verwenden die Überschrift-Hierarchie, um den Benutzern die Navigation zu erleichtern. Leitlinien:
- Überspringen Sie keine Kursstufen (H1 → H3 ohne H2)
- Verwenden Sie keine Überschriften nur für die visuelle Formatierung (verwenden Sie stattdessen fett oder CSS)
- Erhalten Sie den Überschriftentext sinnvoll Vermeiden Sie Abschnitt 1, Teil A
- Halten Sie die Überschriften prägnant, aber beschreibend
Überschrift-Rendering nach Plattform
| Plattform | H1-H6 | Automatische Identifikatoren | Automatisierbarkeit |
|---|---|---|---|
| GitHub | ✅ | ✅ | ✅ (über Schaltfläche) |
| Obsidian | ✅ | ✅ | Über Plugin |
| GitBook | ✅ | ✅ | ✅ (Seitenleiste) |
| Notion | Nur H1-H3 | ❌ | ❌ |
| VS-Code-Vorschau | ✅ | ✅ | ❌ |
| Das ist nicht wahr. | ✅ | ✅ | ✅ |
Notion unterstützt nur drei Überschriftenstufen (in ihrem Editor als Überschriften 1, 2 und 3 bezeichnet, die mit H1H3 verknüpft sind).
Häufige Fehler
Vergessen Sie den Raum nach #
#Not a heading ← Missing space
# This is correctDer Abstand zwischen # und der Überschrifttext ist in CommonMark erforderlich.
Verwendung von Überschriften für die Gestaltung, nicht für die Struktur
Verwendung ### Wenn man einen Text etwas kleiner macht, ohne dass er tatsächlich ein Unterabschnitt ist, bricht man die Struktur des Dokuments. Verwenden Sie stattdessen stilisierten Text oder CSS-Klassen.
Übernässerung Wenn Sie H5 und H6 benötigen, sollten Sie darüber nachdenken, ob der Inhalt in getrennte Seiten aufgeteilt werden sollte.
FAQ
Was ist der Unterschied zwischen ATX und Setext?
ATX-Verwendungen # Charaktere. Setext unterstreicht die Verwendungsmöglichkeiten (=== für H1 --- für H2). ATX wird bevorzugt, weil es eindeutig ist und für H1H6 funktioniert.
Kann ich mehrere H2s haben? Ja, genau darum geht es. H2 definiert wichtige Abschnitte, und ein Dokument hat in der Regel mehrere.
Wird das Überspringen von Kursniveaus SEO beeinflussen? Es beeinflusst die Zugänglichkeit mehr als SEO direkt, aber eine saubere semantische Struktur ist ein positives Signal. Suchmaschinen bevorzugen gut strukturierte Inhalte.
Mein konvertiertes Dokument hat alle Überschriften auf der gleichen Ebene. Was ist schief gelaufen? Das Word-Dokument verwendet manuelle Formatierung anstelle von Heading-Styles. Sehen Sie Word zu Markdown Formatierungsleitfaden Für die Lösung.
Schlußfolgerung
Markdown Überschriften sind einfach in der Syntax, aber wichtig in der Wirkung. Verwenden Sie H1 einmal als Dokumententitel, H2 für Hauptabschnitte und H3 für Unterabschnitte. Halten Sie die Hierarchie sauber, überspringen Sie keine Ebenen und schreiben Sie beschreibende Überschriften. Beim Konvertieren von Word-Dokumenten mit WordToMD, stellen Sie sicher, dass die Quelle Words eingebaute Heading-Stile für eine saubere Konvertierung verwendet.