# Markdown から Typst へ

Markdown のノートを Typst のソースに変換し、高速なローカルの執筆プロジェクトとして開きます。

Markdown から Typst へは、Markdown の手軽な出だしを活かしたまま、下書きの準備が整ったところで、より表現力のある組版システムを与えます。一般的な構造と数式は引き継がれ、結果は形を変えられるプレーンなソースのままです。

## こんなときに使う

- ノートが育って、報告書、配布資料、論文になったとき
- Markdown の下書きに、もっと凝ったページデザインが必要なとき
- 内容を打ち直さずに Typst を試したいとき

目新しさだけで変換しないでください。リポジトリ、静的サイト、共同執筆者が Markdown を前提としているなら、Markdown の持ち運びやすさのほうが、レイアウトを細かく制御できることより価値があるかもしれません。

## ソースを変換する

1. **Markdown から Typst へ**を開くか、`/markdown-to-typst` を実行します。
2. Markdown を貼り付けます。
3. **変換**を選びます。
4. 生成された Typst を確認します。
5. コピーするか、`converted.typ` を保存するか、Typst プロジェクトを作成します。

たとえば、Markdown の見出し、太字のテキスト、番号付きリスト、ドル記号で囲んだ数式は、それぞれ Typst の対応するものになります。変換は、同梱の Pandoc を使ってローカルで実行されます。

## あとで調整すること

Markdown には多くの方言があります。タスクリスト、生の HTML、独自のディレクティブ、引用の拡張、プラグインの構文は、引き継がれないことがあります。Typst でも、テンプレート、参考文献のスタイル、ページの寸法、再利用できる関数について、それぞれ選ぶ必要があります。

新しいプロジェクトをコンパイルして、次の点を確認してください。

- 見出しの階層とリストの入れ子
- 数式とコードブロック
- リンクと画像のパス
- 脚注と引用
- コア仕様に含まれない Markdown の拡張

LaTeX での投稿なら、[Markdown から LaTeX へ](/docs/tools/markdown-to-latex/)を直接使います。逆方向には、[Typst から Markdown へ](/docs/tools/typst-to-markdown/)を使います。空の Typst の作業環境が欲しいときは、[ビジュアル Typst エディタ](/docs/tools/visual-typst-editor/)か [Typst エディタ](/docs/tools/typst-editor/)から始めてください。