なぜ TYP を MD に変換するのですか？
.typ ファイルは Typst 固有のマークアップですが、.MD は GitHub、静的サイトジェネレーター、ノートアプリなどで広く読み取れる軽量な Markdown です。変換することで、プレーンなコンテンツを Typst から解放し、Wiki、README、またはドキュメントパイプラインで活用できるようになります。
TYP から MD への変換方法
Pandoc (コマンドライン)
Pandoc 3.1.8 以降で「pandoc -f typst -t markdown main.typ -o main.md」を実行し、Typst ソースを Markdown ファイルに変換します。
Pandoc から GitHub-flavored Markdown への変換
リポジトリの README やドキュメント用に GitHub-flavored Markdown が特に必要な場合は、「pandoc -f typst -t gfm main.typ -o main.md」を使用します。
これらの形式について
.TYP
Typst Source Document
.typ ファイルは、オープンソースのマークアップベースの組版システムである Typst 用に作成されたプレーンテキストのソースドキュメントです。テキストに Typst マークアップ、数式、スクリプトが混在した状態で保持されており、Typst コンパイラによって PDF、PNG、または SVG に変換されます。任意のテキストエディタで開いて編集できますが、Typst…
.TYP の詳細を開く →
.MD
Markdown Document
MDファイルはMarkdownドキュメントです。見出しには #、強調には 太字 といったシンプルな記号を使用するプレーンテキストです。任意のテキストエディタで生のコンテンツを開けます。適切に整形された状態で表示するには、VS…
.MD の詳細を開く →品質と注意点
- Typst リーダーには制限があります。
#set/#showルール、カスタム関数、パッケージは、多くの場合無視されるかフラット化されます。 - Markdown には Typst のような精密なレイアウトの概念がないため、段組み、正確な間隔、配置された要素などは削除されます。
- 一部の構文（特定の水平線や複雑な表など）は不完全に変換される可能性があり、手動でのクリーンアップが必要になる場合があります。
よくある質問
Pandoc は本当に Typst ソースを読み取れるのですか？
はい。Pandoc は 3.1.x シリーズで Typst リーダーを追加したため、
-f typst で .typ ファイルを直接読み取ることができます。Typst の数式は Markdown に変換されますか？
数式は Markdown 内で LaTeX 形式の数式として保持され、ほとんどのレンダラーで表示可能です。
一部の書式が消えてしまったのはなぜですか？
Markdown は最小限の構成であるため、Markdown で表現できない Typst 固有のスタイリングやレイアウトは削除されます。
どの Markdown フレーバーをターゲットにすべきですか？
標準の
markdown がデフォルトです。GitHub 用には -t gfm を、厳密な CommonMark 用には -t commonmark を使用してください。
