Kurz gesagt
- Markdown ist ein Klartextformat zum Schreiben, das Dokumentstrukturen mit Textzeichen ausdrückt und sich in HTML umwandeln lässt, wobei die Kompatibilität zwischen Varianten nicht garantiert ist.
- Unter Windows oder auf dem Mac wählen Sie die Datei über Öffnen in einem Klartexteditor aus. Auf dem Smartphone benötigen Sie eine App, die Klartextdateien öffnet. Für eine formatierte Browseransicht wandeln Sie die Datei mit einem zur Variante passenden Konverter in HTML um und prüfen die Ausgabe.
- Die Klartextansicht birgt vergleichsweise geringe Risiken. Bösartige Unicode-Steuerzeichen können jedoch die sichtbare Textrichtung verändern. HTML-Vorschauen können Skripte, Weiterleitungen, entfernte Downloads und die Übertragung persönlicher Informationen ermöglichen. Prüfen und bereinigen oder blockieren Sie problematisches Markup; siehe [RFC 7763, Abschnitt 2](https://www.rfc-editor.org/rfc/rfc7763.html#section-2).
Markdown-Dateien (.md, .markdown) öffnen und umwandeln
Dateien mit .md oder .markdown enthalten lesbaren Quelltext. Die ursprüngliche Syntax unterstützt Überschriften, Listen, Zitate, Code, Hervorhebungen, Links und Bilder. Siehe die [Originalbeschreibung von Markdown](https://daringfireball.net/projects/markdown/).
Verwenden Sie einen Markdown-zu-HTML-Konverter, der die Variante der Datei unterstützt. Kontrollieren Sie das Ergebnis: Die ursprüngliche Syntax erlaubt eingebettetes HTML, verarbeitet aber keine Markdown-Zeichen innerhalb von HTML-Blöcken. Siehe die [Syntaxdokumentation](https://daringfireball.net/projects/markdown/syntax).
So bekommst du sie auf
Unter Windows oder auf dem Mac wählen Sie die Datei über Öffnen in einem Klartexteditor aus. Auf dem Smartphone benötigen Sie eine App, die Klartextdateien öffnet. Für eine formatierte Browseransicht wandeln Sie die Datei mit einem zur Variante passenden Konverter in HTML um und prüfen die Ausgabe.
Unter Windows oder auf dem Mac wählen Sie die Datei über Öffnen in einem Klartexteditor aus. Auf dem Smartphone benötigen Sie eine App, die Klartextdateien öffnet. Für eine formatierte Browseransicht wandeln Sie die Datei mit einem zur Variante passenden Konverter in HTML um und prüfen die Ausgabe.
Verwenden Sie einen Markdown-zu-HTML-Konverter, der die Variante der Datei unterstützt. Kontrollieren Sie das Ergebnis: Die ursprüngliche Syntax erlaubt eingebettetes HTML, verarbeitet aber keine Markdown-Zeichen innerhalb von HTML-Blöcken. Siehe die [Syntaxdokumentation](https://daringfireball.net/projects/markdown/syntax).
Dateisicherheit
Die Klartextansicht birgt vergleichsweise geringe Risiken. Bösartige Unicode-Steuerzeichen können jedoch die sichtbare Textrichtung verändern. HTML-Vorschauen können Skripte, Weiterleitungen, entfernte Downloads und die Übertragung persönlicher Informationen ermöglichen. Prüfen und bereinigen oder blockieren Sie problematisches Markup; siehe [RFC 7763, Abschnitt 2](https://www.rfc-editor.org/rfc/rfc7763.html#section-2).
Unbekannter Absender, ein Name mit zwei Endungen oder ein Inhalt, der nicht zur Endung passt — erst prüfen, dann öffnen.
Umwandeln
Verwenden Sie einen Markdown-zu-HTML-Konverter, der die Variante der Datei unterstützt. Kontrollieren Sie das Ergebnis: Die ursprüngliche Syntax erlaubt eingebettetes HTML, verarbeitet aber keine Markdown-Zeichen innerhalb von HTML-Blöcken. Siehe die [Syntaxdokumentation](https://daringfireball.net/projects/markdown/syntax).
Wandle eine Kopie um, nie das Original, und vergleich danach Qualität, Metadaten und Layout mit der Ausgangsdatei.
Häufige Fragen
Was ist eine Markdown-Datei und wofür wird sie verwendet?
Sie enthält Klartext mit Zeichen für Überschriften, Listen, Links und andere Strukturen. Übliche Endungen sind .md und .markdown. Der Text lässt sich in HTML umwandeln.
Wie kann ich eine MD-Datei unter Windows öffnen?
Starten Sie einen Klartexteditor und wählen Sie die .md-Datei über Öffnen aus. So lesen und bearbeiten Sie den Quelltext. Für eine formatierte Ansicht benötigen Sie einen Markdown-Renderer.
Wie kann ich eine Markdown-Datei auf dem Mac öffnen?
Wählen Sie die Datei über Öffnen in einem Klartexteditor aus. Eine formatierte Ansicht erfordert einen Renderer, der die Markdown-Variante des Dokuments unterstützt.
Wie kann ich eine Markdown-Datei auf dem Smartphone öffnen?
Verwenden Sie eine App, die Klartextdateien öffnen kann. Für eine formatierte Darstellung prüfen Sie, ob die App die verwendete Markdown-Variante unterstützt.
Wie kann ich Markdown im Browser anzeigen?
Nutzen Sie eine zur Variante passende Vorschau oder wandeln Sie das Dokument in HTML um und öffnen Sie die Ausgabe im Browser. Dateiübertragung und HTML-Filterung hängen vom gewählten Dienst ab.
Warum sieht Markdown in verschiedenen Editoren unterschiedlich aus?
Editoren können unterschiedliche Varianten verwenden und unbekannte Syntax anders auslegen oder ignorieren. Prüfen Sie die Variantenunterstützung und eingebettete HTML-Blöcke: Darin verarbeitet das ursprüngliche Markdown keine Markdown-Zeichen.
Sollte ich für ein Dokument Markdown oder HTML verwenden?
Markdown eignet sich für gut lesbaren Klartext mit einfachen Strukturzeichen. HTML eignet sich, wenn Sie das Markup einer Seite direkt ausdrücken möchten. Markdown lässt sich in HTML umwandeln.
Wie kann ich Markdown ohne Formatierungsverlust in HTML umwandeln?
Wählen Sie einen zur Quellvariante passenden Konverter und vergleichen Sie die Ausgabe mit dem Original. Die Erhaltung ist zwischen Varianten nicht garantiert; ursprüngliches Markdown verarbeitet keine Markdown-Zeichen in HTML-Blöcken.
Können Skripte in der Markdown-Vorschau ausgeführt werden?
Ja, wenn die Vorschau aktives eingebettetes HTML zulässt. Auch Weiterleitungen und entfernte Zugriffe sind möglich. Verwenden Sie eine Bereinigung oder Blockierung des Markups und lesen Sie unbekannte Dateien zunächst als Klartext.
Welchen MIME-Typ hat eine Markdown-Datei und besitzt sie eine magische Zahl?
RFC 7763 registriert text/markdown sowie die Endungen .md und .markdown. Eine magische Zahl beziehungsweise feste Byte-Signatur ist nicht vorgesehen.
Verwandte Formate
Quellen
Daring Fireball: Markdown · 格式原作者 John Gruber 的官方网站
Markdown Syntax Documentation · 格式原作者发布的语法说明
RFC 7763: The text/markdown Media Type · IETF 发布的 Markdown 媒体类型注册文档