Resources
Was ist Markdown?
Markdown ist eine Art, formatierten Text mit gewöhnlichen Zeichen zu schreiben. Sie tippen **bold**
or # A heading, und eine Markdown-App zeigt es als fetten Text oder als Überschrift. Die Datei selbst bleibt reiner Text, lesbar in jedem Editor auf jedem Rechner, heute und in zwanzig Jahren.
Woher es kommt
John Gruber schuf Markdown 2004 zusammen mit Aaron Swartz, um fürs Web zu schreiben, ohne HTML zu tippen. Der Gedanke: Ein Markdown-Dokument soll sich schon vor dem Formatieren natürlich lesen – eine Zeile
# sieht aus wie eine Überschrift, ein - am Zeilenanfang sieht aus wie ein Listenpunkt, und
*emphasis* sieht hervorgehoben aus.
Seitdem ist es das Alltagsformat von Schreibenden, Entwickelnden und Studierenden geworden. README-Dateien auf GitHub, Vorlesungs- und Lernnotizen, Notizen in Apps wie Marknote und Obsidian, Dokumentationsseiten, Chat-Apps und Foren nutzen es alle.
Warum Menschen in Markdown schreiben
- Es ist reiner Text. Kein proprietäres Dateiformat, nichts umzuwandeln, und jedes Werkzeug kann es öffnen.
- Die Hände bleiben auf der Tastatur. Formatieren sind ein oder zwei Zeichen, kein Ausflug zur Symbolleiste.
- Es hält. A
.md -Datei, die heute geschrieben wird, öffnet sich auch in Jahrzehnten in jedem Texteditor.
- Es passt zur Versionsverwaltung. Änderungen zeigen sich in Git Zeile für Zeile, sodass Notizen und Dokumente wie Code geprüft werden können.
- Es lässt sich in alles umwandeln. Aus derselben Datei wird eine Webseite, ein PDF oder eine Präsentation.
Die Grundsyntax
Das meiste, was Sie brauchen, passt in eine Tabelle. Links steht, was Sie tippen; rechts, was dabei herauskommt.
| Element |
Sie tippen |
Sie erhalten |
|---|
| Überschriften |
# Überschrift 1
## Überschrift 2
### Überschrift 3 |
Überschrift 1 Überschrift 2 Überschrift 3 |
|---|
| Fett und kursiv |
**fett**, *kursiv* und ***beides*** |
fett, kursiv und beides |
|---|
| Durchgestrichen |
~~stimmt nicht mehr~~ |
stimmt nicht mehr
|
|---|
| Aufzählung |
- Milch
- Brot
- Vollkorn |
|
|---|
| Nummerierte Liste |
1. Marknote öffnen
2. Einen Ordner wählen
3. Losschreiben |
- Marknote öffnen
- Einen Ordner wählen
- Losschreiben
|
|---|
| Aufgabenliste |
- [x] Entwurf
- [ ] Prüfung |
|
|---|
| Link |
[Marknote](https://marknote.md) |
Marknote |
|---|
| Bild |
 |
das Bild, mit seinem Alternativtext |
|---|
| Zitat |
> Reiner Text bleibt. |
Reiner Text bleibt. |
|---|
| Code im Text |
Run `git status` first |
Führen Sie git status zuerst aus |
|---|
| Codeblock |
```python
print("hello")
``` |
print("hello") |
|---|
| Tabelle |
| Tarif | Preis |
| :---- | ----: |
| Free | 0 £ | |
|
|---|
| Trennlinie |
--- |
|
|---|
Spielarten von Markdown
Die ursprüngliche Beschreibung ließ manche Fälle offen, also füllten die Apps die Lücken auf leicht unterschiedliche Weise. Zwei Standards klären heute die meisten davon:
- CommonMark ist eine genaue Spezifikation der Kernsyntax, sodass derselbe Text überall gleich formatiert wird.
- GitHub Flavored Markdown baut auf CommonMark auf, mit Tabellen, Aufgabenlisten, Durchstreichungen und automatischen Links.
Darüber hinaus ergänzen Apps eigene Erweiterungen. In Marknote schreiben Sie außerdem Formeln mit LaTeX ($E = mc^2$), zeichnen Diagramme mit Mermaid und verbinden Notizen mit Wiki-Links wie
[[Meeting notes]], während die Dateien gewöhnliches Markdown bleiben.
Erste Schritte
Sie müssen nicht alles auf einmal lernen. Überschriften, Fettdruck, Listen und Links decken das meiste alltägliche Schreiben ab, der Rest kommt, wenn Sie ihn brauchen. Probieren Sie die Syntax oben in der playground, bauen Sie eine Tabelle mit dem Tabellengenerator, oder halten Sie die
Tastenkürzel bereit, sobald Sie in Marknote schreiben.
Markdown mit Live-Vorschau schreiben
Marknote ist ein kostenloser Markdown-Editor für Windows: Tabs, eine Live-Vorschau mit Formeln und Diagrammen und Notizen, die aufeinander verweisen. Ihre Notizen bleiben einfache .md Dateien.
