Blog

Markdown-Tabellen prüfen und als HTML speichern

Markdown-Notizen im Browser ansehen, Überschriften und Tabellen prüfen und als HTML-Datei speichern. Echte Bildschirmfotos zeigen, wann Kopieren und wann Herunterladen sinnvoll ist.

Das englische Werkzeug mit Markdown-Prüfnotizen links und einer Überschrift mit Ergebnistabelle rechts.

Wer Prüfergebnisse in Markdown festhält, kann sie als HTML-Datei weitergeben. Die andere Person kann sie dann im Browser lesen, auch ohne Markdown-Editor. Mit der Markdown-Vorschau und Konvertierung lässt sich der Quelltext mit der Darstellung vergleichen und prüfen, ob die Tabelle wie vorgesehen aufgebaut ist.

Prüfnotizen einfügen und die Tabelle kontrollieren

  1. Beim Öffnen des Werkzeugs erscheint ein Beispiel. Wähle die Funktion zum Leeren, in der englischen Oberfläche „Clear“, und füge das folgende Beispiel in das Feld „Markdown“ ein.
  2. Prüfe, ob die GFM-Erweiterungen für Tabellen und Aufgabenlisten aktiviert sind. In der englischen Oberfläche heißt die Option „GFM extensions (tables/tasks)“.
  3. Die HTML-Vorschau zeigt die Überschrift Weekly checks und eine Tabelle mit den beiden Zeilen Backups und Alerts. Entsteht keine Tabelle, prüfe, ob direkt unter der Kopfzeile eine Trennzeile mit --- steht und alle Zeilen dieselbe Anzahl an Spalten haben.
# Weekly checks

## Results

| Item | Status |
| --- | --- |
| Backups | OK |
| Alerts | Pending |
Englische Oberfläche mit Markdown-Überschriften und einer durch senkrechte Striche getrennten Tabelle links sowie Weekly checks und einer Tabelle mit zwei Zeilen rechts.
Quelltext und Darstellung vergleichen und prüfen, ob Spalten oder Zeilen fehlen.

Eine HTML-Datei zum Öffnen im Browser speichern

  1. Wähle unter der Vorschau die Funktion zum Herunterladen von HTML („Download HTML“). Die Datei wird als converted.html gespeichert.
  2. Öffne die gespeicherte Datei im Browser und prüfe die Überschrift und den Tabelleninhalt. Die Datei enthält grundlegende Darstellungsstile; Tabellenrahmen und Abstände unterscheiden sich deshalb etwas von der Vorschau im Werkzeug.
Englische Oberfläche mit Copy HTML und Download HTML unter der Vorschau und dem erzeugten HTML darunter.
Zum Speichern einer Datei Download HTML verwenden.

Um das Ergebnis in eine vorhandene Webseite einzufügen, verwende die Funktion zum Kopieren von HTML („Copy HTML“). Kopiert wird das Inhaltsfragment aus dem Feld für das erzeugte HTML. Soll der Markdown-Text später weiterbearbeitet werden, bewahre auch den Quelltext auf, etwa in einer .md-Datei.

Die Umwandlung findet im Browser statt. Enthält der Markdown-Text jedoch Bilder mit externen URLs, kann der Browser diese beim Anzeigen der Vorschau oder Öffnen der gespeicherten HTML-Datei abrufen. Ein Dokument nur mit Überschriften und Tabellen wie in diesem Beispiel lässt sich nach dem Speichern als HTML auch offline lesen. Bei einer Veröffentlichung auf GitHub oder Qiita sollte zusätzlich die Vorschau am Ziel geprüft werden, da sich Syntaxerweiterungen und Darstellung unterscheiden können.