Fußnoten
Fußnoten sind eine Erweiterungsfunktion von Markdown, die es Ihnen ermöglicht, Referenznotizen oder ergänzende Informationen zu Dokumenten hinzuzufügen, sodass Leser zusätzliche Erklärungen anschauen können, ohne ihren Lesefluss zu unterbrechen.
Grundlegende Syntax
Fußnoten hinzufügen
Das Erstellen von Fußnoten in Markdown besteht aus zwei Teilen: dem Fußnotenmarker und dem Fußnoteninhalt.
Dies ist ein Absatz, der eine Fußnote[^1] enthält.
[^1]: Dies ist der Fußnoteninhalt.
Rendering-Effekt:
Dies ist ein Absatz, der eine Fußnote[^1] enthält.
[^1]: Dies ist der Fußnoteninhalt.
Mehrere Fußnoten
Markdown ist eine leichte Markup-Sprache[^1] von John Gruber[^2], die jetzt in vielen Bereichen verwendet wird[^3].
[^1]: Markdown verwendet einfache Syntax, um Textformatierungen zu erreichen.
[^2]: John Gruber erstellte Markdown 2004.
[^3]: Viele Plattformen wie GitHub, Stack Overflow und Blog-Plattformen unterstützen Markdown.
Rendering-Effekt:
Markdown ist eine leichte Markup-Sprache[^2], von John Gruber[^3], die jetzt in vielen Bereichen verwendet wird[^4].
[^2]: Markdown verwendet einfache Syntax, um Textformatierungen zu erreichen. [^3]: John Gruber erstellte Markdown 2004. [^4]: Viele Plattformen wie GitHub, Stack Overflow und Blog-Plattformen unterstützen Markdown.
Erweiterte Verwendung
Fußnoten-Identifikatoren
Fußnoten-Identifikatoren können Zahlen oder Wörter sein, aber sie dürfen keine Leerzeichen oder Tabulatoren enthalten.
Hier ist eine normale Fußnote[^1] und eine Fußnote mit einem Identifikator[^note].
[^1]: Dies ist eine normale Fußnote.
[^note]: Dies ist eine Fußnote mit einem Identifikator.
Rendering-Effekt:
Hier ist eine normale Fußnote[^5] und eine Fußnote mit einem Identifikator[^note].
[^5]: Dies ist eine normale Fußnote. [^note]: Dies ist eine Fußnote mit einem Identifikator.
Mehrzeilige Fußnoten
Fußnoteninhalte können mehrere Absätze oder andere Elemente enthalten, was eine korrekte Einrückung erfordert.
Dies ist eine Fußnote, die mehrere Absätze[^multipara] enthält.
[^multipara]: Dies ist der erste Absatz der Fußnote.
Dies ist der zweite Absatz der Fußnote. Mindestens vier Leerzeichen oder ein Tabulator einrücken.
> Sie können auch Fußnoten mit Blockzitaten einfügen.
- Sie können auch Listen einfügen
- Sowohl geordnete als auch ungeordnete Listen werden unterstützt
Rendering-Effekt:
Dies ist eine Fußnote, die mehrere Absätze[^multipara] enthält.
[^multipara]: Dies ist der erste Absatz der Fußnote.
Dies ist der zweite Absatz der Fußnote. Mindestens vier Leerzeichen oder ein Tabulator einrücken.
> Sie können auch Fußnoten mit Blockzitaten einfügen.
- Sie können auch Listen einfügen
- Sowohl geordnete als auch ungeordnete Listen werden unterstützt
Inline-Fußnoten
Einige Markdown-Implementierungen unterstützen die Inline-Fußnotensyntax, aber dies ist kein Standard-Markdown.
Dies ist eine Inline-Fußnote^[Fügen Sie den Fußnoteninhalt direkt im Text ein, anstatt am Ende des Dokuments zu platzieren].
Rendering-Effekt (auf unterstützten Plattformen):
Dies ist eine Inline-Fußnote^[Fügen Sie den Fußnoteninhalt direkt im Text ein, anstatt am Ende des Dokuments zu platzieren].
Kompatibilität und Implementierungsdifferenzen
Unterstützungsstatus auf verschiedenen Plattformen
Plattform/Tool | Standard-Fußnoten | Inline-Fußnoten | Mehrzeilige Fußnoten |
---|---|---|---|
GitHub Markdown | ✅ | ❌ | ✅ |
GitLab Markdown | ✅ | ✅ | ✅ |
Jekyll (kramdown) | ✅ | ✅ | ✅ |
Hugo | ✅ | ✅ | ✅ |
CommonMark | ❌ | ❌ | ❌ |
VitePress | ✅ | ✅ | ✅ |
Pandoc | ✅ | ✅ | ✅ |
HTML-Ausgabe-Format
Die meisten Markdown-Prozessoren konvertieren Fußnoten in HTML mit Links und Rückwärtspfeilen:
<!-- Fußnoten-Referenz -->
<p>Dies ist ein Absatz, der eine Fußnote<sup id="fnref:1"><a href="#fn:1" class="footnote-ref">1</a></sup> enthält.</p>
<!-- Fußnoteninhalt (normalerweise am Ende des Dokuments) -->
<div class="footnotes">
<hr>
<ol>
<li id="fn:1">
<p>Dies ist der Fußnoteninhalt.<a href="#fnref:1" class="footnote-backref">↩</a></p>
</li>
</ol>
</div>
Empfehlungen und Best Practices
Wann sollten Sie Fußnoten verwenden?
Fußnoten eignen sich für folgende Situationen:
- Quellenangaben: Zitieren von Forschungs- und Referenzmaterialien
- Ergänzende Erklärungen: Bereitstellen zusätzlicher Informationen ohne den Hauptinhalt zu unterbrechen
- Weitere Leseempfehlungen: Bereitstellen zusätzlicher Ressourcen für interessierte Leser
- Terminologie-Erklärungen: Erklären technische Begriffe oder Abkürzungen
Fußnoten-Typographie-Empfehlungen
✅ Empfohlene Praktiken:
1. **Platzieren Sie Fußnoteninhalte am Ende**: Setzen Sie alle Fußnotendefinitionen am Ende des Dokuments, um die Wartung zu erleichtern
2. **Wahren Sie Konsistenz**: Verwenden Sie konsistente Fußnotenmarkierungsmethoden (Zahlen oder bedeutende Identifikatoren)
3. **Verwenden Sie moderat**: Zu viele Fußnoten können Leser stören
4. **Bieten Sie bedeutende Inhalte**: Fußnoten sollten tatsächliche Wert hinzufügen, nicht nur den Haupttext wiederholen
❌ Praktiken, die Sie vermeiden sollten:
1. Verwenden mehrerer Fußnoten in einem Satz
2. Verwenden Sie Fußnoten, um Kerninformationen anzuzeigen
3. Platzieren Sie zu lange Inhalte in Fußnoten
4. Verschachteln Sie Fußnoten in Fußnoten
Fußnoten in langen Dokumenten
Für sehr lange Dokumente können Sie Fußnoten nach Kapiteln gruppieren:
# Kapitel 1
Dies ist der Inhalt von Kapitel 1, der eine Fußnote[^1-1] enthält.
[^1-1]: Die erste Fußnote von Kapitel 1.
# Kapitel 2
Dies ist der Inhalt von Kapitel 2, der eine weitere Fußnote[^2-1] enthält.
[^2-1]: Die erste Fußnote von Kapitel 2.
Häufige Problemlösungen
Fußnoten werden nicht angezeigt
Wenn Ihre Fußnoten nicht korrekt angezeigt werden:
- Stellen Sie sicher, dass der Fußnoten-Identifikator und die Fußnotendefinition exakt übereinstimmen (einschließlich Groß-/Kleinschreibung)
- Überprüfen Sie, ob die Fußnotendefinition das korrekte Format hat (Leerzeichen nach dem Doppelpunkt erforderlich)
- Überprüfen Sie, ob Ihr Markdown-Prozessor Fußnotensyntax unterstützt
- Versuchen Sie, Leerzeilen vor und nach Fußnotendefinitionen zu lassen
Verwirrung bei der Fußnoten-Nummerierung
Einige Prozessoren nummerieren Fußnoten automatisch, auch wenn Sie benutzerdefinierte Identifikatoren verwenden. Dies ist erwartetes Verhalten, und die endgültige Anzeige ist normalerweise fortlaufende Zahlen.
Usability auf mobilen Geräten
Auf mobilen Geräten können Fußnoten-Links klein und schwer anzuklicken sein. Die Verwendung von Lesern, die Fußnoten-Vorschau beim Hover unterstützen, kann dieses Problem verbessern.
Verwandte Syntax
- Links - Grundlegende Link-Syntax
- Strikethrough - Andere Textformatierungsoptionen
- Fenced Code Blocks - Code-Block-Syntax
Übungen und Anwendungen
- Erstellen Sie eine kurze Artikel mit mindestens drei verschiedenen Fußnoten
- Versuchen Sie, eine Fußnote mit mehrzeiligem Inhalt zu erstellen
- Verwenden Sie Fußnoten, um Quellenangaben in akademischen oder technischen Artikeln zu zitieren
Fußnoten sind ein wichtiges Werkzeug, um die Professionalität und Glaubwürdigkeit von Markdown-Dokumenten zu erhöhen. Sie ermöglichen es Ihnen, zusätzliche Informationen bereitzustellen, ohne den Hauptinhalt zu unterbrechen, sodass Dokumente vollständiger und autoritärer erscheinen.