ドキュメント

よくある質問

プラットフォーム、更新、Markdown 対応、復旧、トラブルシューティングの答えと、現行版で分かっている制限です。

Markion とは？

Markion は Rust と GPU 加速 UI フレームワーク GPUI で作ったネイティブなデスクトップ Markdown エディタです。四つの表示——編集、ビジュアル、分割、閲覧——に加え、アウトライン、ファイルツリー、検索と置換、フォーカスとタイプライター、複数形式への書き出しがあります。

• ライセンス： MIT
• リポジトリ： github.com/willmove/markion
• 問題報告： GitHub Issues

どのプラットフォームに対応していますか？

リリースはプラットフォームのコード署名をしていません。初回起動で Gatekeeper（macOS）や SmartScreen（Windows）が出ることがあり、手動で通せば実行できます。Windows x86_64 のアプリ内更新は NSIS ペイロードを Minisign 鍵で別に検証しますが、SmartScreen は消えません。macOS と Linux の更新はシステムのブラウザで配布を開きます。.deb で入れる Linux では必要なランタイム（Wayland / X11 / Vulkan / fontconfig）が自動で入ります。

どの Markdown 構文に対応していますか？

Markion は pulldown-cmark（CommonMark + GFM）を使い、次を有効にしています：

• CommonMark の土台
• GitHub Flavored Markdown：表、取り消し線、タスクリスト、自動リンク
• 脚注
• 数式（$インライン$ と $$ブロック$$）
• ```mermaid Mermaid 図（フェンス——フロー、シーケンスなど）
• スマート句読点（湾曲引用符、ダッシュ）
• 見出し属性
• YAML フロントマター（--- 区切り、title / author / date を書き出しに使用）
• 拡張インライン構文（Markion 固有、pulldown-cmark のテキスト区間の上）：==ハイライト==、^上付き^、~下付き~、:smile: や :heart: などの emoji ショートコード、裸の自動リンク

詳細は Markdown と描画。脚注は常に有効で、単独のスイッチはありません。

四つの表示モードの違いは？

Ctrl+Shift+V で四モードを循環（既定はビジュアル編集）するか、 Ctrl+//Ctrl+E/Ctrl+P/Ctrl+Rで直接切り替えます。編集（ソースのみ）、ビジュアル（WYSIWYG 優先、ソース裏打ち）、分割（左ソース右プレビュー）、閲覧（描画プレビューのみ、編集不可）。切り替えても文書、カーソル／選択、元に戻す、タブごとのスクロールは残ります。詳細は 編集モード。

数式はどう組版されますか？

画面描画（分割／閲覧プレビューとビジュアル編集）は内蔵 RaTeX（KaTeX 互換、同梱フォント）で $インライン$ と $$ブロック$$ をキャッシュ SVG に組版します。ネットも外部 LaTeX も不要です。LaTeX 書き出しはネイティブの $...$/$$...$$ を読者側のツールチェーンに残し、内蔵 DOCX は数式を読みやすい Unicode プレーンテキスト近似に落とします。

自動保存とクラッシュ復旧はどう動きますか？

Markion は既定で入力停止から 5 秒後に復旧スナップショットを書き、名前付き文書は元ファイルへサイレント保存します。「環境設定 → 一般」でサイレント保存を切るか 1–300 秒に変えられます。サイレント保存を切っても復旧は残ります。両方止めるのは enabled = false のときだけです：

[auto_save]
enabled = true
silent_save = true
delay_secs = 5

一度もファイルに保存していない文書は、復旧ディレクトリへ復旧コピーを書きます。Markion が突然終了すると、次回起動でそのコピーから未保存作業を戻す選択肢が出ます。未保存の変更があるときは、タイトルバーのファイル名の横に * が付きます。

大きな文書での性能は？

Markion は派生状態（プレビューブロック、アウトライン、統計、構文ハイライト）を文書バージョンごとにキャッシュし Arc で共有するので、大きな文書でも毎キーですべてを再派生しません。syntect の文法は起動時にメインスレッドの外で読み、初回描画は応答したままです。ソースマップ付きビジュアル編集は局所編集のあと独立に解析できる領域を増分再利用し、Markdown 文脈やバイト範囲が不明なら全体派生に戻します。分割／閲覧プレビューの派生はデバウンスとキャッシュであり、増分ではありません。Markion はなお String バッファで rope ではなく、一部の意味読みは意図して全文解析します。

トラブルシューティング

• macOS が「開発元を検証できないため開けません」と言う。 Gatekeeper です。アプリを右クリックして「開く」、または「システム設定 → プライバシーとセキュリティ」で「このまま開く」。リリースは未署名です。
• Windows SmartScreen がインストーラー実行前に警告する。 「詳細情報 → 実行」をクリック。リリースは未署名です。
• PDF 書き出しのバックエンドはどう選びますか？ 「環境設定 → 書き出し」で内蔵エンジンか Pandoc を選びます。既定の内蔵は中英組版、画像、表、コード、ベクトル数式に対応し、外部ツールは不要です。Pandoc はそのツールチェーンが要り、使えないか変換に失敗すると内蔵へ戻します。ステータスバーが実際のバックエンドを示します。
• カスタムテーマが環境設定に出ない。 .toml がテーマディレクトリにあること（ テーマ・言語・環境設定のデータディレクトリ表）、name が空でなく設定されていること、同名の内蔵テーマがないこと（内蔵が優先）を確認してください。
• ログはどこ？ テーマ・言語・環境設定のデータディレクトリ表のログ列を見てください。起動前に RUST_LOG=debug を付けると詳しくなります。

既知の制限

• ビジュアル編集は WYSIWYG を既定の提示契約にし、標準 Markdown は残します。バイト正確な描画が証明できない構造は、推測のリッチツリー変更ではなくソースを過渡の編集路として残し（WYSIWYG カバレッジのロードマップ）、ブロック並べ替えは重ならないソース境界が証明できるときだけです。
• 画面描画は内蔵 RaTeX で数式を組版します。LaTeX 書き出しはネイティブの $...$/$$...$$ を読者側に残し、内蔵 DOCX の予備路はなお数式を読みやすいプレーンテキスト近似に落とし、組版済みグリフは埋めません。
• ビジュアル表のセルは直接のプレーンテキスト編集ができますが、セル内のリッチインライン書式はまだありません。参照／複数行画像、壊れた表、本文中の HTML 実体は WYSIWYG ロードマップ上の既知の欠落で、当面はソース駆動の編集路を残します。
• ワンクリック更新は Minisign 検証のあと Windows NSIS 版を入れます。macOS バンドル差し替えと Linux の .deb／AppImage 自己差し替えは今後の作業で、更新の身元確認は Windows Authenticode でも Apple 公証でもありません。
• 完全なカスタムテーマ導入 UI は未実装で、テーマファイルは手動でテーマディレクトリに置きます。
• 画像書き出しは文書組版の静的スナップショットで、巨大文書はまだすべての派生サブシステムで rope や完全増分解析を使っていません。

問題を報告する

GitHub Issues へお願いします。Markion のバージョン（起動ログの先頭行）とプラットフォームを添えると助かります。