Warum TYP in MD konvertieren?
Eine .typ-Datei ist Typst-spezifisches Markup, während .MD leichtgewichtiges Markdown ist, das von GitHub, statischen Website-Generatoren und Notiz-Apps überall gelesen werden kann. Die Konvertierung befreit den reinen Inhalt aus Typst, damit er in Wikis, READMEs oder Dokumentations-Pipelines genutzt werden kann.
Wie man TYP in MD konvertiert
Pandoc (Kommandozeile)
Führen Sie mit Pandoc 3.1.8+ pandoc -f typst -t markdown main.typ -o main.md aus, um die Typst-Quelle in eine Markdown-Datei umzuwandeln.
Pandoc zu GitHub-flavored Markdown
Verwenden Sie pandoc -f typst -t gfm main.typ -o main.md, wenn Sie speziell GitHub-flavored Markdown für ein Repository-README oder eine Dokumentation benötigen.
Über diese Formate
Eine .typ-Datei ist ein Nur-Text-Quelldokument, das für Typst geschrieben wurde, ein quelloffenes, Markup-basiertes Satzsystem. Sie enthält Ihren Text gemischt mit Typst-Markup, Mathematik…
.TYP-Details öffnen →
.MD
Markdown Document
Eine MD-Datei ist ein Markdown-Dokument: Klartext, der einfache Markierungen wie # für Überschriften und fett für Hervorhebungen verwendet. Jeder Texteditor öffnet den rohen Inhalt. Um ihn…
.MD-Details öffnen →Qualität & worauf zu achten ist
- Der Typst-Reader ist begrenzt:
#set- und#show-Regeln, benutzerdefinierte Funktionen und Pakete werden oft ignoriert oder vereinfacht. - Markdown kennt kein Konzept für das präzise Layout von Typst, daher werden Spalten, exakte Abstände und positionierte Elemente verworfen.
- Einige Konstrukte (bestimmte horizontale Linien oder komplexe Tabellen) können unvollkommen konvertiert werden und erfordern möglicherweise eine manuelle Nachbearbeitung.
Häufig gestellte Fragen
Liest Pandoc wirklich Typst-Quellcode?
-f typst .typ-Dateien direkt liest.Wird Typst-Mathematik in Markdown konvertiert?
Warum sind einige Formatierungen verschwunden?
Welchen Markdown-Dialekt sollte ich wählen?
markdown ist der Standard; verwenden Sie -t gfm für GitHub oder -t commonmark für striktes CommonMark.
