# Typst から HTML へ

プロジェクトを作らずに、Typst のマークアップを、MathML の数式を含む単独で完結する HTML に変換します。

Typst から HTML へは、貼り付けた Typst を、どのブラウザでも開ける 1 つの HTML ファイルにします。数式は MathML として書き出されるので、読者はそれを選択でき、支援技術も読み上げられます。

## こんなときに使う

- 短い Typst 文書やノート一式のウェブ版
- スマートフォンや狭い画面で折り返して表示する必要がある内容
- 作業中のセクションの、手早い HTML 版

PDF のページデザインはコピーしません。正確なレイアウトが重要なときは、PDF を書き出してください。

## ソースを変換する

1. **Typst から HTML へ**を開くか、`/typst-to-html` を実行します。
2. Typst の断片か完全な文書を貼り付けるか、**例を読み込む**を選びます。
3. **変換**を選びます。
4. HTML をコピーするか `converted.html` を保存して、ブラウザで開きます。
5. 見出し、リンク、数式、表、画像を確認します。

例:

```typst
= Result
For $x > 0$, the loss decreases.
```

は、HTML の見出しと段落になり、行内数式は MathML になります。

## 出力に含まれるもの

同梱の Pandoc が Typst を読み込み、お使いのデバイス上で、MathML の数式と埋め込めるリソースを含む、単独で完結する HTML 文書を書き出します。

Pandoc が読むのは Typst のマークアップであり、Typst のスクリプトではありません。`#let` の関数、`show` ルール、パッケージ、計算された内容は、省かれたり単純化されたりすることがあります。Typst プロジェクト全体なら、代わりにプロジェクトの**書き出し**メニューを使ってください。Typst 自身の出力から HTML を作るので、数式や参照がより多く保たれます。選択肢については、[プロジェクトの書き出しと変換](/docs/export/)で説明しています。

:::caution[アクセシブルな HTML にも確認が必要]
MathML と本物の見出しは良い出発点ですが、認定ではありません。ページをアクセシブルだと言う前に、キーボードでの移動順、リンクのテキスト、画像の説明、表の見出し、色のコントラストを確認してください。
:::

LaTeX のソースには、[LaTeX から HTML へ](/docs/tools/latex-to-html/)を使います。
