Markdown: Unterschied zwischen den Versionen
Artikel erstellt. |
Kategorien aktualisiert. |
||
| (Eine dazwischenliegende Version desselben Benutzers wird nicht angezeigt) | |||
| Zeile 1: | Zeile 1: | ||
'''Markdown''' ist eine leichtgewichtige beziehungsweise vereinfachte [[Auszeichnungssprache]]. Mit ihr lassen sich Formatierungselemente zu Textdokumenten hinzufügen, deren Ausgangsform Klartext ist.<ref name="quelle-1">''Markdown Guide'': [https://www.markdownguide.org/getting-started/ ''Getting Started | Markdown Guide''], abgerufen am 13. Juli 2026.</ref> | '''Markdown''' ist eine leichtgewichtige beziehungsweise vereinfachte [[Auszeichnungssprache]]. Mit ihr lassen sich Formatierungselemente zu Textdokumenten hinzufügen, deren Ausgangsform Klartext ist.<ref name="quelle-1">''Markdown Guide'': [https://www.markdownguide.org/getting-started/ ''Getting Started | Markdown Guide''], abgerufen am 13. Juli 2026.</ref> Markdown ist eine einfache Textsyntax, mit der sich formatierte Inhalte für das Web ohne HTML-Kenntnisse erstellen lassen.<ref name="quelle-10">''markdown.de'': [https://markdown.de/?source=post_page--------------------------- ''Markdown Syntax-Dokumentation''], abgerufen am 13. Juli 2026.</ref><ref name="quelle-11">''Deutsche Schachjugend'': [https://www.deutsche-schachjugend.de/hilfe/markdown ''Markdown''], abgerufen am 13. Juli 2026.</ref> | ||
== Entstehung == | == Entstehung == | ||
Markdown wurde 2004 von [[John Gruber]] entwickelt.<ref name="quelle-6">''CommonMark and the Future of Scholarly Markdown'': [https://doi.org/10.53731/r294649-6f79289-8cw06 ''CommonMark and the Future of Scholarly Markdown''], Front Matter, 7. September 2014, abgerufen am 13. Juli 2026.</ref> | Markdown wurde 2004 von [[John Gruber]] entwickelt.<ref name="quelle-6">''CommonMark and the Future of Scholarly Markdown'': [https://doi.org/10.53731/r294649-6f79289-8cw06 ''CommonMark and the Future of Scholarly Markdown''], Front Matter, 7. September 2014, abgerufen am 13. Juli 2026.</ref> | ||
== Grundlegende Syntax == | |||
Die grundlegende Markdown-Syntax umfasst unter anderem Überschriften, Absätze und Zeilenumbrüche, Hervorhebungen, Zitate, Listen, Code, horizontale Trennlinien, Links, Bilder und das Maskieren von Sonderzeichen.<ref name="quelle-16">''Markdown Guide'': [https://www.markdownguide.org/basic-syntax/ ''Basic Syntax''], abgerufen am 13. Juli 2026.</ref> | |||
{| class="wikitable" | |||
! Element | |||
! Eingabe → Ergebnis | |||
|- | |||
| Überschrift | |||
| <code><nowiki>### Meine Überschrift</nowiki></code> → Überschrift der Ebene 3.<ref name="quelle-16" /> | |||
|- | |||
| Fettdruck | |||
| <code><nowiki>**wichtiger Hinweis**</nowiki></code> → '''wichtiger Hinweis''' (fett).<ref name="quelle-16" /> | |||
|- | |||
| Nummerierte Liste | |||
| <code><nowiki>1. Erster Punkt</nowiki></code> → geordneter Listeneintrag.<ref name="quelle-16" /> | |||
|- | |||
| Link | |||
| <code><nowiki>[Markdown Guide](https://www.markdownguide.org)</nowiki></code> → anklickbarer Text „Markdown Guide“.<ref name="quelle-16" /> | |||
|- | |||
| Inline-Code | |||
| <code><nowiki>`datei.md`</nowiki></code> → Inline-Code.<ref name="quelle-16" /> | |||
|} | |||
Absätze werden durch mindestens eine Leerzeile voneinander getrennt.<ref name="quelle-16" /><ref name="quelle-11" /> Werden alle Zeilen eines Blocks mit mindestens vier Leerzeichen oder einem Tabulator eingerückt, werden sie als [[Codeblock]] dargestellt.<ref name="quelle-16" /><ref name="quelle-11" /> | |||
== Listen == | == Listen == | ||
Markdown unterstützt sowohl geordnete als auch ungeordnete Listen.<ref name="quelle-3">''Markdown Syntax-Dokumentation'': [https://markdown.de/?source=post_page--------------------------- ''markdown.de | Markdown Syntax-Dokumentation''], abgerufen am 13. Juli 2026.</ref> In einer ungeordneten Liste können die Zeichen <code>*</code>, <code>+</code> oder <code>-</code> als Markierungen der einzelnen Listenpunkte verwendet werden.<ref name="quelle- | Markdown unterstützt sowohl geordnete als auch ungeordnete Listen.<ref name="quelle-3">''Markdown Syntax-Dokumentation'': [https://markdown.de/?source=post_page--------------------------- ''markdown.de | Markdown Syntax-Dokumentation''], abgerufen am 13. Juli 2026.</ref> In einer ungeordneten Liste können die Zeichen <code>*</code>, <code>+</code> oder <code>-</code> als Markierungen der einzelnen Listenpunkte verwendet werden.<ref name="quelle-3" /> Ein untergeordneter Listenpunkt kann durch vier Leerzeichen eingerückt werden.<ref name="quelle-3" /> Bei einer geordneten Liste werden die einzelnen Punkte nummeriert.<ref name="quelle-3" /> | ||
== Varianten == | == Varianten == | ||
Markdown-Anwendungen implementieren häufig jeweils leicht unterschiedliche Versionen der Auszeichnungssprache. Solche Varianten werden als „Flavors“ bezeichnet.<ref name="quelle-1" /> | Markdown-Anwendungen implementieren häufig jeweils leicht unterschiedliche Versionen der Auszeichnungssprache. Solche Varianten werden als „Flavors“ bezeichnet.<ref name="quelle-1" /> Insbesondere werden erweiterte Syntaxelemente nicht von allen Markdown-Anwendungen unterstützt.<ref name="quelle-12">''Markdown Guide'': [https://www.markdownguide.org/cheat-sheet/ ''Markdown Cheat Sheet''], abgerufen am 13. Juli 2026.</ref><ref name="quelle-16" /> | ||
RFC 7764 enthält Registrierungsvorlagen für mehrere solcher Syntaxen. Aufgeführt sind MultiMarkdown, [[GitHub Flavored Markdown]], Pandoc, Fountain, [[CommonMark]], kramdown-rfc2629, rfc7328 und PHP Markdown Extra.<ref name="quelle-2">RFC 7764: [https://www.rfc-editor.org/rfc/rfc7764.html ''Guidance on Markdown: Design Philosophies, Stability Strategies, and Select Registrations''], abgerufen am 13. Juli 2026.</ref> | RFC 7764 enthält Registrierungsvorlagen für mehrere solcher Syntaxen. Aufgeführt sind MultiMarkdown, [[GitHub Flavored Markdown]], [[Pandoc]], Fountain, [[CommonMark]], kramdown-rfc2629, rfc7328 und PHP Markdown Extra.<ref name="quelle-2">RFC 7764: [https://www.rfc-editor.org/rfc/rfc7764.html ''Guidance on Markdown: Design Philosophies, Stability Strategies, and Select Registrations''], abgerufen am 13. Juli 2026.</ref> | ||
== Praktische Strukturierung == | == Praktische Strukturierung == | ||
Für konsistent strukturierte Markdown-Dokumente empfiehlt der Google-Styleguide eine einzige [[Überschrift]] der Ebene H1. Diese Überschrift dient als Titel des Dokuments.<ref name="quelle-4">''Markdown style guide'': [https://google.github.io/styleguide/docguide/style.html ''Markdown style guide''], styleguide, abgerufen am 13. Juli 2026.</ref> Alle nachfolgenden Überschriften sollen auf der Ebene H2 oder einer tieferen Ebene beginnen | Für konsistent strukturierte Markdown-Dokumente empfiehlt der Google-Styleguide eine einzige [[Überschrift]] der Ebene H1. Diese Überschrift dient als Titel des Dokuments.<ref name="quelle-4">''Markdown style guide'': [https://google.github.io/styleguide/docguide/style.html ''Markdown style guide''], styleguide, abgerufen am 13. Juli 2026.</ref> Alle nachfolgenden Überschriften sollen auf der Ebene H2 oder einer tieferen Ebene beginnen.<ref name="quelle-4" /> | ||
Der Styleguide empfiehlt außerdem, nach Möglichkeit die Standardsyntax von Markdown zu verwenden und [[HTML]]-Behelfslösungen zu vermeiden.<ref name="quelle-4" /> | Der Styleguide empfiehlt außerdem, nach Möglichkeit die Standardsyntax von Markdown zu verwenden und [[HTML]]-Behelfslösungen zu vermeiden.<ref name="quelle-4" /> | ||
== Weblinks == | |||
* [https://markdown.de/ markdown.de: Markdown Syntax-Dokumentation] | |||
* [https://www.markdownguide.org/basic-syntax/ Markdown Guide: Basic Syntax] | |||
* [https://google.github.io/styleguide/docguide/style.html Google Markdown Style Guide] | |||
== Einzelnachweise == | == Einzelnachweise == | ||
<references /> | <references /> | ||
[[Kategorie:Auszeichnungssprachen]] | |||
[[Kategorie:Textformate]] | |||
Aktuelle Version vom 14. Juli 2026, 17:17 Uhr
Markdown ist eine leichtgewichtige beziehungsweise vereinfachte Auszeichnungssprache. Mit ihr lassen sich Formatierungselemente zu Textdokumenten hinzufügen, deren Ausgangsform Klartext ist.[1] Markdown ist eine einfache Textsyntax, mit der sich formatierte Inhalte für das Web ohne HTML-Kenntnisse erstellen lassen.[2][3]
Entstehung
Markdown wurde 2004 von John Gruber entwickelt.[4]
Grundlegende Syntax
Die grundlegende Markdown-Syntax umfasst unter anderem Überschriften, Absätze und Zeilenumbrüche, Hervorhebungen, Zitate, Listen, Code, horizontale Trennlinien, Links, Bilder und das Maskieren von Sonderzeichen.[5]
| Element | Eingabe → Ergebnis |
|---|---|
| Überschrift | ### Meine Überschrift → Überschrift der Ebene 3.[5]
|
| Fettdruck | **wichtiger Hinweis** → wichtiger Hinweis (fett).[5]
|
| Nummerierte Liste | 1. Erster Punkt → geordneter Listeneintrag.[5]
|
| Link | [Markdown Guide](https://www.markdownguide.org) → anklickbarer Text „Markdown Guide“.[5]
|
| Inline-Code | `datei.md` → Inline-Code.[5]
|
Absätze werden durch mindestens eine Leerzeile voneinander getrennt.[5][3] Werden alle Zeilen eines Blocks mit mindestens vier Leerzeichen oder einem Tabulator eingerückt, werden sie als Codeblock dargestellt.[5][3]
Listen
Markdown unterstützt sowohl geordnete als auch ungeordnete Listen.[6] In einer ungeordneten Liste können die Zeichen *, + oder - als Markierungen der einzelnen Listenpunkte verwendet werden.[6] Ein untergeordneter Listenpunkt kann durch vier Leerzeichen eingerückt werden.[6] Bei einer geordneten Liste werden die einzelnen Punkte nummeriert.[6]
Varianten
Markdown-Anwendungen implementieren häufig jeweils leicht unterschiedliche Versionen der Auszeichnungssprache. Solche Varianten werden als „Flavors“ bezeichnet.[1] Insbesondere werden erweiterte Syntaxelemente nicht von allen Markdown-Anwendungen unterstützt.[7][5]
RFC 7764 enthält Registrierungsvorlagen für mehrere solcher Syntaxen. Aufgeführt sind MultiMarkdown, GitHub Flavored Markdown, Pandoc, Fountain, CommonMark, kramdown-rfc2629, rfc7328 und PHP Markdown Extra.[8]
Praktische Strukturierung
Für konsistent strukturierte Markdown-Dokumente empfiehlt der Google-Styleguide eine einzige Überschrift der Ebene H1. Diese Überschrift dient als Titel des Dokuments.[9] Alle nachfolgenden Überschriften sollen auf der Ebene H2 oder einer tieferen Ebene beginnen.[9]
Der Styleguide empfiehlt außerdem, nach Möglichkeit die Standardsyntax von Markdown zu verwenden und HTML-Behelfslösungen zu vermeiden.[9]
Weblinks
Einzelnachweise
- ↑ 1,0 1,1 Markdown Guide: Getting Started | Markdown Guide, abgerufen am 13. Juli 2026.
- ↑ markdown.de: Markdown Syntax-Dokumentation, abgerufen am 13. Juli 2026.
- ↑ 3,0 3,1 3,2 Deutsche Schachjugend: Markdown, abgerufen am 13. Juli 2026.
- ↑ CommonMark and the Future of Scholarly Markdown: CommonMark and the Future of Scholarly Markdown, Front Matter, 7. September 2014, abgerufen am 13. Juli 2026.
- ↑ 5,0 5,1 5,2 5,3 5,4 5,5 5,6 5,7 5,8 Markdown Guide: Basic Syntax, abgerufen am 13. Juli 2026.
- ↑ 6,0 6,1 6,2 6,3 Markdown Syntax-Dokumentation: markdown.de | Markdown Syntax-Dokumentation, abgerufen am 13. Juli 2026.
- ↑ Markdown Guide: Markdown Cheat Sheet, abgerufen am 13. Juli 2026.
- ↑ RFC 7764: Guidance on Markdown: Design Philosophies, Stability Strategies, and Select Registrations, abgerufen am 13. Juli 2026.
- ↑ 9,0 9,1 9,2 Markdown style guide: Markdown style guide, styleguide, abgerufen am 13. Juli 2026.