# Typst から Markdown へ

Typst のマークアップを、コピー、保存、または Markdown プロジェクトとして開ける、持ち運びやすい Markdown に変換します。

Typst から Markdown へは、Typst の下書きの言葉と基本的な構造を残し、ページのデザインを捨てます。結果は、wiki、リポジトリ、Markdown エディタで使えるプレーンテキストです。

## こんなときに使う

- ページレイアウトより文章が重要なとき
- ノートや下書きを Markdown のシステムに移すとき
- 共同執筆者が、Typst を使わない単純なソースを求めているとき

テンプレート、`show` ルール、正確なページデザインが成果物の一部であるときは、Typst にとどまってください。

## 下書きを変換する

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

例:

```typst
= Method
We minimize $L(theta)$ with two constraints.
- Bounded error
- Stable updates
```

は、Markdown の見出し、ドル記号で囲んだ数式を含む段落、箇条書きになります。

## もう一度見直すべきもの

同梱の Pandoc が、お使いのデバイス上でソースを変換します。見出し、強調、リンク、リスト、コード、一般的な数式は、たいていきれいに対応します。Typst の関数、`#let` の定義、`show` ルールと `set` ルール、パッケージ、独自のレイアウトを持つ図は、対応しないことがあります。

変換のあとで、数式の区切り、画像のパス、脚注、参照、表を確認してください。Typst プロジェクト全体を Markdown として書き出すには、プロジェクトの**書き出し**メニューを使います。数式や参照がより多く保たれます。詳しくは、[プロジェクトの書き出しと変換](/docs/export/)で説明しています。

逆方向には、[Markdown から Typst へ](/docs/tools/markdown-to-typst/)を使います。ワープロ文書として渡すなら、[Typst から Word へ](/docs/tools/typst-to-word/)を使います。
