Testpaket auf GitHub herunterladen
Wählen Sie Code → Download ZIP, damit Dokument und Bilddateien zusammenbleiben. Im Repository können Sie vor dem Download auch den Quelltext ansehen und Änderungen prüfen.
Das Paket steht unter der offenen Lizenz CC BY 4.0. Sie dürfen das Testmaterial mit Namensnennung weiterverwenden oder anpassen. Die App Markdific wird dadurch nicht zu Open Source.
Kurz gesagt: Laden Sie die ZIP-Datei herunter, öffnen Sie dieselbe
.md-Datei in jedem Tool, notieren Sie, was korrekt dargestellt wird, und speichern und exportieren Sie dann eine Arbeitskopie. Halten Sie Darstellung, Markdown-Roundtrips und Exportformate als getrennte Ergebnisse fest.
Was der Test abdeckt
Das Dokument in Version 1.0 hat 30 nummerierte Abschnitte. Jeder Abschnitt gibt an, ob er CommonMark, GitHub Flavored Markdown (GFM), eine verbreitete Erweiterung, App-spezifische Syntax, HTML-Verhalten oder einen Roundtrip testet.
| Bereich | Beispiele | Was zu prüfen ist |
|---|---|---|
| CommonMark | Überschriften, Links, Listen, Zitate, Code, Zeilenumbrüche | Parsing und Dokumentstruktur |
| GFM | Tabellen, Aufgabenlisten, durchgestrichener Text, automatische Links | Unterstützung erweiterter Syntax |
| Bilder | PNG, JPEG, WebP, Dateinamen mit Leerzeichen, externe Bilder | Laden und Erhalt der Pfade |
| Technische Inhalte | LaTeX-Formeln und sieben Mermaid-Diagrammtypen | Vorschau, Quelltext als Fallback, Export |
| App-spezifische Syntax | Obsidian-Wikilinks, Einbettungen, Callouts, Tags | Portabilität und Wiederherstellbarkeit |
| Roundtrips | Öffnen, bearbeiten, speichern und exportieren | Umgeschriebener Quelltext und verlorene Inhalte |
Formeln, Mermaid und Obsidian-Syntax sind nicht Teil von CommonMark selbst. Ein Tool kann CommonMark korrekt darstellen, ohne sie zu unterstützen. Das Paket ist ein praxisnahes Vergleichsdokument, keine formale Testsuite für Standardkonformität.
So vergleichen Sie fair
- Laden Sie die ZIP-Datei des Repositorys herunter. Entpacken Sie sie, ohne das
.md-Dokument vonassets/zu trennen. - Behalten Sie eine unveränderte Referenzkopie. Notieren Sie App-Version, Betriebssystem, Renderer-Modus und Testdatum.
- Öffnen Sie eine Arbeitskopie im ersten Tool. Prüfen Sie die dargestellte Ausgabe und, wo verfügbar, den Quelltext.
- Nehmen Sie eine kleine Änderung vor, speichern Sie als Markdown und vergleichen Sie die gespeicherte Datei mit der Referenzkopie.
- Exportieren Sie in jedes Format, das das Tool anbietet, etwa HTML, PDF oder DOCX. Öffnen Sie jeden Export und prüfen Sie ihn einzeln.
- Wiederholen Sie das mit derselben Referenzkopie in den anderen Tools. Füllen Sie die Ergebnistabelle im Dokument aus.
Fassen Sie nicht alle Beobachtungen in einer einzigen Bewertung „unterstützt Markdown“ zusammen. Ein Viewer kann ein Diagramm darstellen, aber nicht bearbeiten. Ein Konverter kann das Aussehen im PDF erhalten, aber den Mermaid-Quelltext verlieren. Das sind unterschiedliche Ergebnisse.
Ergebniskategorien
- Bestanden (Pass): Struktur und Bedeutung bleiben bei der getesteten Aktion erhalten.
- Teilweise (Partial): Der Inhalt bleibt nutzbar, aber Formatierung, Quelltext, Metadaten oder Bearbeitbarkeit ändern sich.
- Nicht unterstützt (Unsupported): Eine optionale Syntaxerweiterung ist nicht umgesetzt, der Quelltext bleibt aber wiederherstellbar.
- Fehlgeschlagen (Fail): Inhalte verschwinden, werden irreführend, führen unsicheren Code aus oder lassen sich nicht wiederherstellen.
- Nicht getestet (Not tested): Die Aktion ließ sich nicht durchführen oder trifft nicht zu.
Halten Sie fest, worauf jede Einstufung beruht. So ist „Mermaid als lesbarer Codeblock angezeigt“ in der Regel Nicht unterstützt und nicht Fehlgeschlagen, es sei denn, das Tool gibt an, Mermaid darzustellen.
Bildtests: Was laden sollte und was nicht
Die ZIP-Datei enthält sechs funktionierende lokale Testbilder: PNG, JPEG, WebP, einen Dateinamen mit Leerzeichen, ein per HTML eingebundenes Bild und ein eingefügtes Bild im Obsidian-Stil. Lassen Sie assets/ neben dem Dokument liegen. Alle sechs Dateien zeigen absichtlich dieselbe einfache Grafik, damit der Vergleich nur Dateiformat und Pfadbehandlung prüft und keine anderen visuellen Unterschiede.
Zwei weitere Pfade lassen sich im eigenständigen Paket absichtlich nicht auflösen. Ein Pfad relativ zum übergeordneten Ordner setzt eine größere Ordnerstruktur voraus, ein Pfad relativ zum Stammverzeichnis einer Website setzt eine Website voraus. Das externe Bild setzt einen Netzwerkzugang voraus. Diese Fälle testen, wie ein Tool fehlende oder externe Dateien erklärt; es fehlen keine Dateien in der ZIP-Datei.
Wenn keines der mitgelieferten lokalen Bilder lädt, prüfen Sie zuerst das Entpacken, die Ordnerstruktur und die Zugriffsrechte für lokale Dateien, bevor Sie den Renderer bewerten.
Was Sie nach dem Speichern und Exportieren prüfen sollten
Eine visuelle Vorschau kann Änderungen am Quelltext verbergen. Prüfen Sie das gespeicherte Markdown auf verlorene Linkziele, umgeschriebene Bildpfade, kaputte Tabellen, veränderte Begrenzungszeilen von Codeblöcken, maskierte Zeichen oder gelöschte Metadaten. Eine harmlose Vereinheitlichung der Formatierung ist etwas anderes als verlorene Bedeutung.
Prüfen Sie beim PDF Seitenumbrüche, Zeilenumbruch im Code, Formeln, Auflösung der Diagramme und Links. Prüfen Sie bei DOCX, ob Überschriften, Tabellen, Listen und Bilder bearbeitbar bleiben. Prüfen Sie bei HTML die Struktur, lokale Dateien und den sicheren Umgang mit eingebettetem HTML.
Das Dokument enthält einen harmlosen Skripttest. Eine sichere Vorschau kann das Skript maskieren, entfernen oder als Quelltext anzeigen, ohne es auszuführen. Werten Sie eine blockierte Skriptausführung nicht als Fehler.
Nachvollziehbare Ergebnisse teilen
Wenn Sie einen Vergleich veröffentlichen, geben Sie die Version des Pakets (1.0), Tool und Version, Betriebssystem, Konfiguration, Importmethode, Exporteinstellungen, die ausgefüllte Ergebnistabelle und Screenshots relevanter Unterschiede an. Nennen Sie alle Änderungen an der Testdatei.
Markdific hat das Paket erstellt und ist möglicherweise eine der getesteten Apps. Verwenden Sie für jede App dieselbe Datei und dieselben Bewertungskriterien. Werten Sie das Fehlen einer optionalen Funktion nicht als Mangel, nur weil ein anderes Produkt sie bietet.
Download und Weiterverwendung
Markdown Compatibility Test Pack auf GitHub öffnen
Mit Code → Download ZIP erhalten Sie das .md-Dokument, assets/, die README und die Lizenz zusammen.
Das Dokument und die mitgelieferten Testbilder stehen unter der Lizenz CC BY 4.0. Nennen Sie „Markdific Markdown Compatibility Test Pack v1.0“, verlinken Sie Repository und Lizenz und kennzeichnen Sie Änderungen, wenn Sie das Material anpassen.
Häufige Fragen
Ist das eine offizielle Testsuite von CommonMark?
Nein. CommonMark hat eine eigene Spezifikation und eigene Konformitätsbeispiele. Dieses Paket testet praxisnahe Dokumente und Arbeitsabläufe, einschließlich Erweiterungen und Export.
Kann ich einen Static-Site-Generator testen?
Ja. Notieren Sie Engine, Plug-ins, Konfiguration, Theme, Build-Version und die Regeln für Dateipfade. Vergleichen Sie das erzeugte HTML und die Dateien, nicht nur die Entwicklungsvorschau.
Darf ich das Testpaket veröffentlichen oder ändern?
Ja, unter CC BY 4.0. Nennen Sie die Quelle, verlinken Sie die Lizenz und kennzeichnen Sie Änderungen. Behalten Sie die ursprüngliche Versionsangabe in Vergleichsergebnissen bei, damit Leser wissen, was getestet wurde.