# HTML から Typst へ

意味を持つ HTML を、編集、コンパイル、またはプロジェクト化できる単体の Typst 文書に変換します。

HTML から Typst へは、構造化されたウェブのマークアップから Typst のソースを作ります。見出し、段落、強調、リスト、リンク、単純な表が変換されるので、手で組み直す必要がありません。

## こんなときに使う

- HTML を自分で書いたか、その内容を再利用する許可があるとき
- ページが、見出し、段落、リストなど、意味のある要素を使っているとき
- ページの見た目のコピーではなく、文書の構造を Typst で手に入れたいとき

HTML そのものを貼り付けてください。このツールは、ウェブページのダウンロード、スクリプトの実行、CSS や JavaScript に依存するレイアウトの再構築は行いません。

## マークアップを変換する

1. **HTML から Typst へ**を開くか、`/html-to-typst` を実行します。
2. HTML の断片か完全な文書を貼り付けるか、**例を読み込む**を選びます。
3. **変換**を選びます。
4. 生成された Typst を読みます。
5. コピーするか、`converted.typ` を保存するか、**プロジェクトを作成**を選んで Typst プロジェクトとして開きます。

例:

```html
<h2>Method</h2>
<p>We compared <strong>three</strong> conditions.</p>
<ul><li>Control</li><li>Treatment</li></ul>
```

は、Typst の見出し、太字を含む段落、箇条書きになります。

## 移っても残るもの

Oleafly に同梱の Pandoc が、お使いのデバイス上で意味的な構造を変換します。グリッドのレイアウト、レスポンシブのブレークポイント、アニメーション、ほとんどの CSS のスタイルには、Typst の対応物がなく、省かれます。

変換のあとで、リンク、コードブロック、表、入れ子のリスト、画像の参照を確認してください。このツールは、リモートの画像やスタイルシートを取得しません。`.html` ファイルを画像と一緒に取り込むには、ライブラリの**プロジェクトを読み込む → HTML ページ**を使います。Typst プロジェクトを作成して、埋め込まれた画像を `assets/` に抽出できます。[読み込みガイド](/docs/import-project/)で説明しています。

LaTeX に変換したいときは、[HTML から LaTeX へ](/docs/tools/html-to-latex/)を使います。
