Markdown sitzt. Und kneift an wenigen Stellen

Markdown ist eine Methode, um einen Text mit Formatierungen auszustatten¹. Seit ich im Oktober 2012 zum ersten Mal mit ihr in Berührung kam, lernte ich sie zunehmend schätzen – aus diesen sieben Gründen:

1. Es gibt zwar Markdown-Apps, aber die sind optional. Falls wir die Syntax intus haben – was kein Elefantengedächtnis erfordert –, können wir genauso einen beliebigen Texteditor verwenden.
2. Es gibt keine Hürden beim Dateiaustausch; die Textdokumente lassen sich beliebig zwischen den Programmen und Plattformen transferieren².
3. Es herrscht eine klare Trennung zwischen Inhalt und Gestaltung: Während ich schreibe, brauche ich mir keine Gedanken darüber zu machen, wie der Text am Ende formatiert werden soll. Es ist jederzeit möglich, die Formatierungsvorlage zu ändern und die Darstellung für verschiedene Zwecke anzupassen.
4. Die Konvertierung in viele andere Formate ist über die Editoren oder über Webanwendungen gewährleistet.
5. Die Dateien sind sauber strukturiert und enthalten (anders als bei Microsoft Word oder Google Docs) keinen Ballast.
6. Sie lassen sich deswegen hervorragend automatisiert verarbeiten. Die gängigen KI-Sprachmodelle verstehen und verwenden Markdown.
7. Schliesslich ist der Markdown-Ansatz ideal für Apps, die uns dabei helfen, uns aufs Wesentliche zu konzentrieren – unsere Inhalte. Ein Beispiel dafür ist die Schweizer Präsentations-Apps IA Presenter.

Eine Erfolgsgeschichte!

Wir dürfen von einer Erfolgsgeschichte sprechen. Die Auszeichnungssprache hat zwar Formatierungs-Monster wie Word nicht hinweggefegt. Aber sie ist inzwischen im «Mainstream» angekommen, wie diese zwei Beispiele belegen:

1) Markdown bei Apple in der Notiz-App

In der Notiz-App am iPhone und iPad lassen sich Einträge im Markdown exportieren. Dazu betätigen wir den Teilen-Knopf und im Sharesheet den Befehl Als Markdown exportieren. (Mehr dazu in meinen Tipps zu iOS 26.)

2) Markdown in Google Docs

Noch toller: Google zeigt in den Office-Anwendungen Herz für Markdown-Freunde:

• In Google Docs weisen wir Formatierungen via Markdown zu. Wir formatieren z.B. einen Absatz als Titel, indem wir ihn mit # einleiten. Damit das klappt, muss unter Tools > Einstellungen in der Rubrik Allgemein die Option Markdown aktivieren eingeschaltet sein.
• Unter Datei > Herunterladen findet sich die Option Markdown (.md), die eine ballastfreie Version des Dokuments produziert. Nachteil: Eingebettete Bilder werden nicht als separate Dateien exportiert, sondern als data URI scheme in die Textdatei integriert (als data:image-Blob). Das ist unpraktisch.

Ich gebe inzwischen Markdown den Vorzug, wenn das praktikabel ist und ich davon ausgehen kann, während der Arbeit nicht an eine ärgerliche Limitation zu stossen.

Grund für Ärger gibt es trotzdem

Dem Lob für Markdown zum Trotz passiert das leider gelegentlich. Das sind die häufigsten Schwachstellen. Neudeutsch würde man von Pain Points sprechen:

• Die Unterstützung für Tabellen ist rudimentär. Es fehlt die Möglichkeit, Elemente in der Zelle auszurichten (rechts, links, oben, unten) oder mehrere Zellen zu verschmelzen.
• Geschützte Leerzeichen lassen sich natürlich via Unicode eingeben (bei Windows, indem wir bei gedrückter Alt-Taste 00160 auf dem Ziffernblock tippen). Das dürfte einfacher gehen.
• Die Position und Grösse von Bildern lassen sich nicht steuern.
• Der Standard wird nicht durchgängig einheitlich umgesetzt – siehe Kommentar von Simon.
• Es gibt zwar ein Format für Zitate (Blockquotes) und Programmcode, aber keines für Bildunterschriften.
• Und vor allem ist die Definition eigener Absatzformate nicht vorgesehen.

Dieses letzte Manko ist meines Erachtens das grösste. Selbst bei simpel strukturierten Dokumenten gibt es bestimmte Elemente, die für die Gliederung des Textes und eine konsistente Struktur speziell ausgezeichnet werden müssten. Ich denke an Dinge wie …

• die Zusammenfassung am Anfang (auch Abstract, Exzerpt oder im journalistischen Kontext Lead genannt),
• Marginalien und Randnotizen,
• Kästen oder Boxen,
• Beispiele, Fussnoten, Definitionslisten,
• Kommentare, die nicht in der publizierten Fassung erscheinen sollen,
• Glossare, Erklärungen, Definitionen und
• Wörter, die im Index erscheinen sollen.

Für diese formalen Aspekte gibt es ein Hintertürchen. Wir dürfen bei vielen Markdown-Editoren auch HTML-Tags im Text unterbringen. Bei Typora, meinem angestammten Editor für Windows, ist das ohne Weiteres möglich: Um dort z. B. ein Exzerpt zu platzieren, könnten wir den HTML-Tag strong mit der passenden Klasse benutzen:

<strong class="excerpt">Das hier ist wichtig</strong>

Eine Box mit mehreren Abschnitten liesse sich über einen div-Block einfügen. Manche Programme unterstützen auch die Erweiterung Fenced Divs, mit der solche Blöcke über mehrere Doppelpunkte eingefügt werden.

Ist das sinnvoll oder verwässert das die Idee der simplen, aufs Wesentliche reduzierten Auszeichnungssprache? Die Antwort darauf hängt, natürlich, von persönlichen Vorlieben ab. Für Nerds eröffnet sich auf alle Fälle ein Tummelfeld ungeahnten Ausmasses. Denn Markdown lässt sich bei Bedarf hervorragend spezifischen Bedürfnissen anpassen. Das zeigt die Variante R Markdown für Statistikerinnen, wovon wir auch im R Markdown Cookbook einen Eindruck erhalten …

Ein abschliessender Tipp: Mit dem erwähnten Editor Typora ist es keine Sache, Dokumente von Google Docs oder Microsoft Word zu übernehmen. Es gibt zwar keine Importfunktion, aber via Zwischenablage klappt es gut. Die meisten (aber leider nicht immer alle) Formatierungen kommen mit, und der Ballast bleibt auf der Strecke.