なぜ TYP を HTML に変換するのですか？
.typ ファイルは Typst コンパイラのみが理解できるソースですが、.HTML はブラウザやウェブが必要とする形式です。エクスポートすることで、Typst ドキュメントを PDF として共有するのではなく、ウェブページとしてオンラインで公開したり埋め込んだりできるようになります。
TYP から HTML への変換方法
typst-cli (ネイティブ HTML エクスポート)
「typst compile --features html --format html main.typ main.html」を実行するか、TYPST_FEATURES=html を設定します。出力は単一のセマンティック HTML ファイルになります。
Pandoc (Typst リーダー経由)
代替案として、Pandoc 3.1.8 以降で「pandoc main.typ -o main.html」を実行すると、Typst ソースからスタイル適用済みのスタンドアロン HTML ページを取得できます。
これらの形式について
.TYP
Typst Source Document
.typ ファイルは、オープンソースのマークアップベースの組版システムである Typst 用に作成されたプレーンテキストのソースドキュメントです。テキストに Typst マークアップ、数式、スクリプトが混在した状態で保持されており、Typst コンパイラによって PDF、PNG、または SVG に変換されます。任意のテキストエディタで開いて編集できますが、Typst…
.TYP の詳細を開く →
.HTML
HyperText Markup Language Web Page
HTML ファイルは Web ページです。ブラウザが読み取って整形されたページとして表示するための、マークアップタグを含むプレーンテキストです。表示するには、ダブルクリックするとブラウザ（Edge、Chrome、Firefox、Safari）で開きます。コードを編集するには、Notepad++ や VS Code などのテキストエディタで開きます。 .html と .htm…
.HTML の詳細を開く →品質と注意点
- Typst の HTML エクスポートは実験的であり、機能フラグ（feature flag）の背後に隠されています。公式ドキュメントでは本番環境での使用を控えるよう警告されています。
- ネイティブのエクスポーターはセマンティックなマークアップのみを出力し、CSS は出力しません。そのため、独自のスタイルシートを追加するまでページは未スタイルの状態です。
- 複雑なレイアウト、配置されたグラフィックス、および一部のパッケージは、HTML 出力では不完全であるか、サポートされていません。
よくある質問
なぜ --features html フラグが必要なのですか？
HTML エクスポートは実験的な機能であるため、Typst はこれを
html 機能フラグの背後に隠しています。このフラグがないと、このフォーマットは利用できません。HTML にスタイルが適用されていないのはなぜですか？
ネイティブのエクスポーターは、設計上 CSS なしのセマンティックマークアップのみを出力します。独自のスタイルシートを追加するか、スタイル適用済みのページが必要な場合は Pandoc を使用してください。
これは本番用のウェブサイトに使用しても安全ですか？
Typst 自身のドキュメントでは「いいえ」とされています。この機能は不完全であり、現時点では実験目的を意図しています。
代わりに Pandoc で実行できますか？
はい。「
pandoc main.typ -o main.html」を実行すると、Typst ソースを読み取ってスタンドアロンの HTML ファイルを生成します。
