Auswahl des richtigen Markdown Parsers

Fenced Codeblocks

Eine der besten Ergänzungen für Entwickler ist die Möglichkeit, Code einfach zu Ihrem Markdown hinzuzufügen. Die ursprüngliche Implementierung betrachtete einen Textblock automatisch als Code, wenn er um 4 Leerzeichen oder einen einzelnen Tab eingerückt war. Das ist manchmal umständlich, daher haben mehrere Implementierungen gefesselte Codeblöcke integriert, indem sie es erlauben, drei Anführungszeichen (`) oder in einigen Fällen drei Tildenzeichen (~) am Anfang eines Textblocks zu setzen, um ihn als Code zu markieren.

```
body {
  margin: 0;
  padding: 0;
  color: #222;
  background-color: white;
  font-family: sans-serif;
  font-size: 1.8rem;
  line-height: 160%;
  font-weight: 400;
}
```

Verfügbar mit
Cebe Markdown, Ciconia, Github Flavored Markdown, Kramdown, Markdown-it, Marked, Maruku, Multi-Markdown, Parsedown, PHP Markdown Extended, Python Markdown, Redcarpet, Remarkable, Showdown

Syntax-Hervorhebung

Das Hinzufügen von Codeblöcken ist großartig, aber standardmäßig wickeln Markdown-Interpreter die Blöcke einfach in <code>- und <pre>-Tags ein, wodurch der Text als vorformatierter Text in einer Schriftart mit fester Breite angezeigt wird. Einige Implementierungen können dies verbessern, indem sie es Ihnen ermöglichen, eine Sprache neben den Anführungszeichen anzugeben und einen Parser einzubinden, der es Ihnen automatisch ermöglicht, verschiedene Farbstile auszuwählen und die Sprache Ihres Codes anzugeben, damit die Farben aussagekräftiger sind.

```css
body {
  margin: 0;
  padding: 0;
  color: #222;
  background-color: white;
  font-family: sans-serif;
  font-size: 1.8rem;
  line-height: 160%;
  font-weight: 400;
}
```

Verfügbar mit
Ciconia, Github Flavored Markdown, Kramdown*, Marked, Maruku, Multi-Markdown, Parsedown, PHP Markdown Extended, Python Markdown, Redcarpet, Remarkable, Showdown

* Ein Teil dieser Unterstützung ist nicht in den Parser eingebettet, sondern hängt von anderen Bibliotheken wie highlight.js ab.

Tabellen

Tabellen in HTML zu schreiben kann umständlich sein. Einige Markdown-Versionen können dies handhaben, indem sie es Ihnen ermöglichen, Tabellen mit einer recht einfachen Syntax hinzuzufügen.

Dimensions | Megapixels
---|---
1,920 x 1,080 | 2.1MP
3,264 x 2,448 | 8MP
4,288 x 3,216 | 14MP

Rendert so

Es dauert ein paar Minuten, um den Dreh beim Erstellen von Tabellen wie dieser herauszufinden, aber nachdem Sie es ein paar Mal gemacht haben, werden Sie es als umständlich empfinden, HTML zu verwenden. Wenn Sie Hilfe beim Erstellen von Tabellen benötigen, schauen Sie sich diesen Markdown Tables Generator an.

Verfügbar mit
Cebe Markdown, Ciconia, Github Flavored Markdown, Kramdown, Markdown-it, Marked, Maruku, Multi-Markdown, Parsedown, PHP Markdown Extended, Python Markdown, Redcarpet, Remarkable, Showdown

Metadaten

Einige Erweiterungen ermöglichen es Ihnen, Metadaten hinzuzufügen, die Sie verwenden können, um Informationen hinzuzufügen, die Ihre App analysieren kann, wie z. B. die Auswahl einer Vorlage oder das Festlegen des Seitentitels. Einige verwenden die Multi-Markdown-Struktur für diese Metadaten, und andere wie der Jekyll-Parser verwenden YAML als Format, was es Ihnen ermöglicht, komplexe Daten innerhalb dieses Metadatenbereichs auszudrücken. Dies kann eine wirklich nützliche Funktion für App-Entwickler sein.

---
Title:  SVG Article
Author: Ray Villalobos
Date:   January 6, 2016
heroimage: "http://i.imgur.com/rBX9z0k.png"
tags:
- data visualization
- bitmap
- raster graphics
- navigation
---

Verfügbar mit
Markdown-it, Maruku, Multi-Markdown, PHP Markdown Extended, Python Markdown, Redcarpet, Remarkable, Showdown

URL-AutoLinking

Diese recht einfache Erweiterung ermöglicht es, URLs, die natürlich in Ihrem Text vorkommen, durch den Parser in Links umzuwandeln. Das ist wirklich praktisch und nützlich in einer Implementierung wie GFM, wo das Klicken auf URLs ohne zusätzlichen Aufwand das Erstellen von Dokumentation erleichtert.

Verfügbar mit
Cebe Markdown, Ciconia, CommonMark, Github Flavored Markdown, Kramdown, Markdown-it, Marked, Maruku, Multi-Markdown, Parsedown, PHP Markdown Extended, Python Markdown, Redcarpet, Remarkable, Showdown

Fragmente/Referenzlinks

Mit HTML können Sie einfach Referenzen innerhalb Ihres Dokuments erstellen, indem Sie ein Hash-Zeichen in Ihrem Anker-Tag mit der ID eines Elements auf einer Seite verwenden. Einige Implementierungen ermöglichen es Ihnen, eine Verknüpfung für diese Art von Referenz zu erstellen. Das ist besonders nützlich, da es Ihnen ermöglicht, Ihr eigenes Dokument schnell zu referenzieren, ohne viele HTML-Tags schreiben zu müssen. Diese Funktion ist sehr unterschiedlich implementiert, daher sollten Sie vorsichtig sein und die Dokumentation für die spezifische Version lesen, die Sie verwenden werden.

You can link to a headline called 'myheadline' in your document using this [My Headline][].

## My Headline
The word 'reference' right next to this will get a link that links via an href to the headline above. The headline, in other words, gets an ID that the link points to.

Verfügbar mit
Ciconia, Multi-Markdown, Maruku, Multi-Markdown, Parsedown, PHP Markdown Extended, Redcarpet, Showdown

Benutzerdefinierte IDs für Überschriften

Eine weitere nützliche Funktion ist die Möglichkeit, IDs in Ihren Überschriften zu haben, damit Sie diese einfacher mit CSS ansprechen können. Einige Parser weisen allen Überschriften automatisch IDs zu (insbesondere wenn sie Fragmente/Referenzen unterstützen), sodass diese Funktion nicht immer notwendig ist. Es ist jedoch schön, dass einige Versionen es Ihnen ermöglichen, anzupassen, wie der Parser die IDs benennt, was manchmal bequemer ist, als Dinge automatisch zu benennen.

### Custom IDs {#custom-id}
The headline above, when rendered by the parser, will have a custom ID that you specify in the curly braces.

Verfügbar mit
Cebe Markdown, Kramdown

Fußnoten & Andere Link-Typen

Fußnoten ermöglichen es Ihnen, Links innerhalb Ihres Dokuments zu Referenzen zu erstellen, die am Ende der Markdown-Seite platziert werden. Das unterscheidet sich von normalen Links, die inline in Ihrem Inhalt platziert werden. Dies ermöglicht es den Benutzern, alle zugehörigen Links innerhalb eines Dokuments in einem einzigen Abschnitt anzuzeigen, was manchmal praktisch ist.

You can find a demo of a site[^Demo] built with PostCSS in our footnotes, or you can checkout the [^Github Repo] for the project.

#### Footnotes
[Demo](http://iviewsource.com/exercises/postcsslayouts)
[Github Repo](https://github.com/planetoftheweb/postcsslayouts)

Verfügbar mit
Cebe Markdown, Kramdown, Markdown-it, Maruku, Multi-Markdown, Parsedown, PHP Markdown Extended, Python Markdown, Redcarpet, Remarkable, Showdown

**Hinweis**: Es gibt viele alternative Linkmethoden in Parsern wie Multi-Markdown. Die Unterstützung dafür ist in den einzelnen Versionen sehr lückenhaft. Das bedeutet, dass auch wenn der Parser „Multi-Markdown“-Kompatibilität bewirbt, verschiedene Parser unterschiedliche Arten von Linkreferenzen implementieren. Dazu gehören Dinge wie Zitate, automatisch generierte IDs in Überschriften, die Möglichkeit, benutzerdefinierte IDs zu erstellen, Referenzlinks und andere. Einige Parser erfinden sogar eigene Link-Funktionen.

To-dos

Dies ist eine Funktion von Github Flavored Markdown, die sich in einigen Implementierungen durchgesetzt hat. Sie fügt Markup für To-do-Listen hinzu, sodass Sie Kontrollkästchen neben Inhalten erstellen können, um eine To-do-Liste zu simulieren.

- [ ] Run `> npm-install` to install the project dependencies
- [X] Install gulp.js via the Mac terminal or Gitbash on a PC `> npm install -g gulp`
- [ ] Run the Gulp command `> gulp`

Verfügbar mit
Ciconia, Github Flavored Markdown, Markdown-it, Marked, Python Markdown, Redcarpet, Showdown

Durchgestrichen

Wenn Sie Text mit Durchstreichen markieren möchten, können Sie in vielen Versionen eine Notation verwenden, die den Text mit dem <s>-Tag umschließt. Für eine umfassendere Implementierung von Redaktionshinweisen sollten Sie jedoch das verwandte Format namens CriticMarkup in Betracht ziehen.

Verfügbar mit
Ciconia, Markdown-it, Marked, Multi-Markdown, Parsedown, Remarkable, Redcarpet, Showdown

Definitionslisten

Obwohl Definitionslisten nicht so verbreitet sind wie andere Listentypen, sind sie eine großartige Möglichkeit, bestimmte Arten von Elementen in HTML zu kodieren. Einige Implementierungen fügen eine Möglichkeit hinzu, diese auf wesentlich einfachere Weise zu erstellen. Es gibt zwei Möglichkeiten, sie zu definieren, abhängig von der Sprache: Verwendung eines Doppelpunkts (`:`) oder einer Tilde (`~`), obwohl die Implementierung mit Doppelpunkten gebräuchlicher ist.

ES6/ES2015
:   The new version of the popular JavaScript language

TypeScript
  ~ TypeScript is a language that is a superset of JavaScript that can be compiled through a transpiler to JavaScript that will work with most browsers.

Verfügbar mit
Kramdown, Markdown-it*, Maruku, Multi-Markdown, PHP Markdown Extended, Python Markdown, Remarkable

* erfordert eine Erweiterung

Mathematik

Die Möglichkeit, mathematische Formeln zu erstellen, kann für einige Benutzer nützlich sein. Daher ist eine Sprache zum Erstellen dieser Formeln in einigen Implementierungen wie Multi-Markdown aufgetaucht. Obwohl einige Sprachen behaupten, sie zu unterstützen, ist Unterstützung in anderen Sprachen verfügbar, manchmal durch eine Erweiterung.

Verfügbar mit
Kramdown*, Maruku, Multi-Markdown, Markdown-it, Python Markdown*

* erfordert eine Erweiterung