Thema: markdown
-
Diagramme als Code mit Mermaid: was gut funktioniert und wo die Grenzen liegen
Mermaid rendert Diagramme aus Text innerhalb von Markdown, sodass Diagramme neben dem Code liegen, sich im Review als Diff zeigen und von GitHub sowie anderen Viewern dargestellt werden; die Grenzen liegen beim automatischen Layout, das sich nicht feinjustieren lässt, bei der Grösse, bei Unterschieden zwischen Renderer-Versionen und bei der Barrierefreiheit, die explizite Title- und Description-Schlüsselwörter braucht.
-
Dokumentstruktur mit Jev wiederherstellen und dabei den Quelltext bewahren
Wahrscheinliche Überschriften, Absätze und Listengrenzen aus beschädigter Formatierung rekonstruieren, ohne dass aus einer strukturellen Reparatur eine nicht nachverfolgte Neufassung des Dokuments wird.
-
Code-Fences in generiertem Text erhalten
Ein Codebeispiel, das Markdown-Fences enthält, darstellen, indem ein äusseres Begrenzungszeichen gewählt wird, das vom Beispiel nicht geschlossen werden kann.
Maschinenlesbar: JSON