HTML und gespeicherte Webseiten unter Windows in Markdown umwandeln

Um eine Webseite als Markdown zu speichern, speichern Sie sie in Chrome oder Edge mit Ctrl+S als „Webseite, vollständig“ und fügen Sie dann die HTML-Datei in MD Factory hinzu. Die App wandelt die Seite auf Ihrem PC um und speichert daneben eine Markdown-Datei mit den Bildern der Seite.

Diese Anleitung ist für Seiten, die Sie für sich aufbewahren: Artikel, Dokumentation, Rezepte, Nachschlageseiten. Wenn Sie HTML in einem Skript oder einem Build umwandeln müssen, springen Sie zum letzten Abschnitt.

Drei ausgedruckte Webseiten-Layouts mit grauen Blöcken und Linien neben einem geschlossenen Laptop. — Eine gespeicherte Seite wird zu einer Notiz, die Sie als reinen Text bearbeiten können.

Seite in Chrome oder Edge speichern

Drücken Sie in Chrome Ctrl+S oder öffnen Sie das Menü „Mehr“, wählen Sie „Streamen, speichern und teilen“ und dann „Seite speichern unter“. Die Schritte stehen in der Chrome-Hilfe.

Drücken Sie in Edge Ctrl+S. Die Tastenkombination steht in den Tastenkombinationen für Edge.

Wählen Sie in der Liste „Dateityp“ die Option „Webseite, vollständig“. Beide Browser bieten drei Formate, und MD Factory behandelt sie unterschiedlich:

Dateityp	Was der Browser speichert	Was Sie in MD Factory erhalten
Webseite, vollständig	Eine HTML-Datei und ein Ordner mit demselben Namen und der Endung _files, der die Bilder enthält	Text und Bilder
Webseite, nur HTML	Nur die HTML-Datei; die Bilder bleiben auf der Website	Text ohne Bilder, mit dem Status „Überprüfung erforderlich“
Webseite, einzelne Datei	Eine MHTML-Datei	Nichts: MD Factory öffnet keine MHTML-Dateien und führt sie als übersprungen auf

Gespeicherte Seite umwandeln

Öffnen Sie MD Factory.
Klicken Sie auf „Dateien hinzufügen“ und wählen Sie die gespeicherte HTML-Datei aus, oder ziehen Sie sie in das Fenster.
Die Umwandlung beginnt sofort. Wenn die Zeile das Ergebnis zeigt, doppelklicken Sie auf den Ergebnispfad, um die Markdown-Datei zu öffnen.

Fügen Sie die HTML-Datei hinzu, nicht den Ordner, in dem sie liegt. Fügen Sie den Ordner hinzu, geht MD Factory auch den Ordner _files durch: Dessen Skripte, Stylesheets und Bilder werden als übersprungen aufgeführt, und HTML-Dateien darin werden als eigene Notizen umgewandelt.

Die Markdown-Datei erhält den Namen der Seite und wird daneben gespeichert. Die darin verwendeten Bilder landen in einem Ordner daneben:

Saved pages/
  Sourdough bread.html
  Sourdough bread_files/
  Sourdough bread.md
  Sourdough bread_images/

Die gespeicherte Seite und ihr Ordner _files bleiben unverändert. Wenn Sie die Markdown-Datei verschieben, verschieben Sie den Ordner _images mit: Das Markdown verweist auf die Bilder in diesem Ordner.

Was in Markdown übernommen wird

Auf der Seite	Im Markdown
Überschriften	Überschriften derselben Ebene
Absätze, Listen und Zitate	Bleiben erhalten, samt fettem und kursivem Text
Codeblöcke und Inline-Code	Bleiben als Code erhalten
Tabellen	Markdown-Tabellen
Mit der Seite gespeicherte Bilder	Werden als PNG-Dateien in den Bilderordner kopiert
Links	Bleiben erhalten, wie unten beschrieben
Skripte, Stylesheets und eingebettete Frames, etwa Videoplayer anderer Websites	Werden entfernt
Website-Menüs, Kopf- und Fußzeilen, Seitenleisten und Cookie-Hinweise	Bleiben als normaler Text und Links erhalten
Der Titel im Browser-Tab	Nicht enthalten

Hat eine Tabelle Kopfzellen, wird ihre erste Zeile zur Kopfzeile der Markdown-Tabelle. Andernfalls ergänzt die App nummerierte Spaltenüberschriften. Verbundene Zellen werden auf das Raster verteilt: Der Wert bleibt in der ersten Zelle, die davon überdeckten Zellen bleiben leer.

Welche Bilder erhalten bleiben

MD Factory lädt nie etwas aus dem Internet herunter. Ein Bild gelangt nur dann ins Markdown, wenn seine Datei auf Ihrem PC liegt:

Bilder im Ordner _files, den „Webseite, vollständig“ erstellt;
Bilder in anderen Ordnern rund um die Seite, einschließlich übergeordneter Ordner;
Bilder, die im HTML-Code selbst eingebettet sind.

Ein Bild, das nur auf der Website existiert, wird weggelassen, und die Datei erhält „Überprüfung erforderlich“. SVG-Bilder werden nicht unterstützt und ebenfalls weggelassen.

Wie Links behandelt werden

Vollständige Webadressen, E-Mail-Links und Telefon-Links bleiben unverändert.
Relative Links, etwa zu einer anderen Seite derselben Website, werden zu vollständigen Webadressen, wenn die gespeicherte Seite ihre ursprüngliche Adresse enthält. Andernfalls bleiben sie unverändert und funktionieren nur, wenn die verlinkte Datei relativ zur Markdown-Datei am selben Ort liegt.
Links zu einem Abschnitt derselben Seite funktionieren weiter, weil die Abschnitte im Markdown ihre Anker behalten.
Links, die beim Klicken ein Skript ausführen, also solche, die mit javascript: beginnen, werden zu einfachem Text.

Notiz aufräumen

MD Factory wandelt den gesamten Textkörper der Seite um. Es versucht nicht zu erraten, welcher Teil der Artikel ist, rechnen Sie also oben mit dem Website-Menü und unten mit Fußzeile, verwandten Links und Cookie-Hinweis. Löschen Sie, was Sie nicht brauchen.

Der Titel aus dem Browser-Tab ist nicht enthalten. Fehlt die eigene Überschrift des Artikels, fügen Sie oben eine hinzu.

Tragen Sie die Adresse der Seite und das Speicherdatum als erste Zeile der Notiz ein. So finden Sie das Original später wieder und können es beim Zitieren angeben.

Wenn Sie Ihre Notizen in Obsidian führen, behandelt unsere Anleitung zum Importieren von Dokumenten in Obsidian das Umwandeln von Dateien in einen Vault und wie Sie ihre Bilder verknüpft halten.

Wenn die Seite „Überprüfung erforderlich“ erhält

„Überprüfung erforderlich“ bedeutet, dass die Markdown-Datei gespeichert wurde, aber etwas von der Seite nicht übernommen werden konnte. Wenn die Warteschlange fertig ist, klicken Sie in der Zeile der Datei auf den Status, um die Meldung zu sehen.

Meldung	Übliche Ursache
Ein externes Bild oder eine externe Ressource wurde übersprungen.	Ein Bild existiert nur auf der Website, zum Beispiel nach dem Speichern als „Webseite, nur HTML“.
Ein Bild konnte nicht exportiert werden.	Die Seite verweist auf eine Bilddatei, die im Ordner fehlt.
Ein Bildformat wird nicht unterstützt.	Das Bild hat ein Format, das die App nicht umwandeln kann, etwa SVG.
Einige Dokumentinhalte konnten in Markdown nicht dargestellt werden.	Die Seite enthielt einen eingebetteten Frame, etwa einen Videoplayer einer anderen Website, und er wurde entfernt.
Ein lokales Linkziel konnte nicht beibehalten werden.	Ein Link zu einer anderen Seite der Website konnte keiner Webadresse und keiner gespeicherten Datei zugeordnet werden. Sein Text bleibt ohne den Link erhalten.
Die Textkodierung wurde abgeleitet. Sonderzeichen prüfen.	Die Seite ist nicht in UTF-8 gespeichert, daher musste die App die Kodierung ermitteln. Prüfen Sie Buchstaben mit Akzenten und Symbole.

HTML im Code umwandeln

Wenn Sie HTML in Markdown in einem Skript, einem Build-Schritt oder einem Scraper benötigen, ist MD Factory das falsche Werkzeug: Es arbeitet über sein Fenster, ohne Befehlszeile und ohne Programmierschnittstelle. Verwenden Sie stattdessen eine Bibliothek. Turndown wandelt HTML in JavaScript in Markdown um, in Node.js oder im Browser, unter der MIT-Lizenz. html2text leistet dasselbe in Python, unter GPL-3.0. Pandoc ist ein Befehlszeilenkonverter zwischen vielen Dokumentformaten, darunter HTML und Markdown. Bei allen dreien legen Sie die Umwandlungsregeln fest und kümmern sich selbst um Bilder und Links.

pandoc -f html -t gfm page.html -o page.md