ドキュメント

Markdown と描画

Markion は pulldown-cmark で Markdown を解析し、CommonMark と GFM を対象にします。Markdown は常に文書の唯一の正規形式です。

書式コマンド

太字、斜体、インラインコード、リンク、画像、見出し、リスト、タスクリスト、引用、フェンスコード、ソースの Markdown 表に対応します。見出しコマンドは既定で H1–H5、環境設定で H1–H6 に広げられます。

検索と置換

大文字小文字の区別、正規表現、次／前の一致、現在を置換、すべて置換に対応します。

表

• ソースの表コマンドは表を整形し、行と列の追加・削除・移動ができます。
• ビジュアル編集の表は、ソースに裏打ちされたセルの直接編集、 Tab での移動、内容に応じた列幅、同じ行／列操作も提供します。
• 通常プレビューの表は読み取り専用のままです。

ローカル画像の流れ

クリップボード画像とドラッグした画像ファイルを取り込みます：

• Markion は衝突しにくい名前で文書相対のアセットディレクトリへコピーまたは符号化し、持ち運びできる相対 Markdown リンクを挿入します。
• 既存画像を差し替えても alt テキストと表示メタデータは残ります。
• 実用的なサイズ／揃えの操作があり、資源がないときは明示的な欠落状態を出します。

YAML フロントマター

--- で区切った YAML フロントマターを解析してプレビューから隠し、その title, author と date は書き出しメタデータ（HTML の <meta> 、DOCX の文書プロパティ、LaTeX プリアンブル）に使います。

描画の対応

描画プレビューは次をサポートします：

• 太字、斜体、取り消し線、インラインコード、リンク、ハイライト（==highlight==）、上付き（^superscript^）、下付き（~subscript~）、脚注、タスクリスト、よく使う emoji ショートコード（ :smile: 、 :heart:など）、自動リンク。
• 正しい番号付きリストの開始番号、入れ子リスト、深さごとの箇条書き、ぶら下げインデント、画像、埋め込み HTML。
• スマート句読点（湾曲引用符、ダッシュ）と見出し属性。

プレビューからのコピー

プレビューのテキストは選択でき、右クリックでプレーンテキスト、Markdown、HTML としてコピーできます。該当すればリンク先のコピーもあります。

数式

$...$ インライン数式と $$...$$ ブロック数式は、内蔵 RaTeX（KaTeX 互換）がオフラインで、同梱フォント付きのキャッシュ SVG に組版します。ネットも外部 LaTeX も不要です。実際には：

• インライン数式は本文と同じ行に流れ、数式内の Unicode も使えます（例 $\text{速度 } v$）。
• 太字、リンク、インラインコードなどの入れ子 Markdown と共存し、それぞれのスタイルを保ちます。
• ```math フェンスブロック（行列環境など）に対応します。
• 幅の広い数式は切り取られず横スクロールします。
• 無効な数式ソースは見え、編集でき、黙って消えません。
• ビジュアル編集では、フォーカスした数式だけが完全な $...$, $$...$$ 、またはフェンスソースを見せます。

LaTeX 書き出しはネイティブの $...$/$$...$$ ソースを残し、読者側のツールチェーンに組版を任せます。内蔵 DOCX 書き出しは数式を読みやすいプレーンテキスト近似に落とし、組版済みグリフは埋めません。

Mermaid 図

```mermaid フェンス図（フローチャート、シーケンス図など）は消毒したキャッシュ SVG に描画します。

コードのハイライト

フェンスコードは syntect と two-face の拡張文法セットで色付けし、未対応言語はフォールバック字句解析、行番号は任意（環境設定または config.toml で切替）です。