Emacs 31 に新登場：

markdown-ts-mode

とは？

Emacs 31 がリリースされました。特に注目すべきは、

markdown-ts-mode

という新しい Markdown モードの実装です。このモードは現時点で**実験的（Experimental）**としてマークされています。本記事では、このモードの特徴、インストール方法、基本機能、および注意点について解説します。

---

1. 機能面での位置付け

markdown-ts-mode

は Tree-sitter を用いた高度な文法解析を行います。

• 実験的モード：導入には同意（opt-in）が必要であり、すべての機能が完全に安定しているとは限りません。
• 対応仕様：
  • CommonMark の完全対応。
  • GitHub Flavored Markdown (GFM) の大部分対応。
  • 付加機能：

    elisp

    などへのコードブロック、目次生成、Pandoc/GFM との連携など。

導入ガイドは Tree-sitter の扱い方が難しいため、まずは設定から始めます。

---

2. インストールと起動手順

Emacs はデフォルトでこのモードを有効にしていません。手動での読み込みが必要です。

ユーザー設定ファイルからの追加

use-package

を使用している場合（推奨）：

(use-package markdown-ts-mode
  :bind (:mode "\\.md\\'" #'markdown-ts-mode)
  :hook (markdown-ts-mode . treesit-ensure))

use-package

を使わない場合：

(require 'markdown-ts-mode)
(add-hook 'markdown-mode #'markdown-ts-mode)
(treesit-ensure)

テスト環境での起動（最小限の設定）

設定ファイルを変更せず試す場合は、以下のコマンドで Emacs を起動します。

emacs -Q --load 'testing.el'

(注：テスト用ファイルを

testing.el

として作成し、中身を読み込む想定)

重要: パッケージマネージャー（MELPA など）へのインストールは不要です。古くアーカイブ化された MELPA は Emacs 31 で動作しません。標準搭載の

markdown-ts-mode

を使用してください。

---

3. 最初の Markdown ファイルを開く

Tree-sitter ベースのモードを使用すると、システムに文法（Grammar）がインストールされていないとエラーになります。

起動時のクイズ

Markdown ファイル（例：

test.md

）を開くと、Emacs がシステム上の文法を見つけられず、以下の手順でインストールを提案します。

1. 「Install grammar？」 と尋ねられますので

   y

   を押します。
   • Emacs はリポジトリからソースをダウンロードし、コンパイルしてインストールします。
2. Markdown では「メイン解析用」と「インライン解析用」の 2 つの文法が必要です。2 番目のインストールも許可しましょう（

   y

   ）。

確認すべき項目

もし表示されない場合は以下の条件を満たしているか確認してください。

• Emacs が Tree-sitter でコンパイルされているか？

  • M-:

    (featurep 'treesit) RET を実行し、

    t

    が返ります。
• 必要なツール（

  make

  ,

  gcc

  など）がインストールされているか？
• Tree-sitter バイナリ（例：

  tree-sitter-cli

  ）が存在するか？

  • tree-sitter --version

    で確認可能です。

文法の自動生成とトラブルシューティング

Tree-sitter モードは「共有資産」です。ファイルに TOML/YAML ヘッダーなどがあると、それに対応する文法が必要です。

• 不足している文法のインストール：

  M-x treesit-install-language-grammar RET yaml RET
  

• 自動的に登録されない場合（YAML の例）は、ソースコードから期待されるリポジトリを確認し、手動でコンパイルしてインストールする必要があります。

重要:

-ts-mode

は文法に依存します。文法の更新に合わせて常に最新の文法を使用する必要があります。

---

4.

markdown-ts-mode

の機能概要

このモードは Org-mode と互換性を重視しており、Emacs ユーザーにとって馴染み深いキーバインディングを持っています。

基本操作：編集 (Editing)

• 太文字:

  **bold**

  （入力） →

  C-c C-x C-f

  で強調。
• 斜体:

  *italic*

  （入力） →

  i

  キーで強調。
• 取り消し線:

  ~~str~~

  →

  s

  キー。
• インラインコード:

  `code`

  →

  c

  キー。
• マークアップの隠し:

  C-c C-x RET

  (

  markdown-ts-toggle-hide-markup

  ) 実行すると、入力記法が見えない状態で編集できます（Org-mode と同様）。
  • ヒント:

    M-q

    はリストや引用内の改行も自動修正します。

見出し (Headings)

• 入力:

  #

  ,

  ##

  , ...

  ######

  または Setext 形式（

  ===

  /

  ---

  ）も認識。
• レベル変更:
  • 昇格:

    M-<left>

  • 降格:

    M-<right>

• 移動:
  • セクション全体を上に/下に移動:

    M-↑

    /

    M-↓

• 折りたたみ: 見出しの

  TAB

  で可視性を切り替え（アウトライン機能）。

リスト (Lists)

• 入力形式:

  -

  ,

  +

  ,

  *

  または番号付きリスト。
• チェックボックス (GFM 準拠):
  • 再生成/削除:

    C-c C-c

    (

    markdown-ts-toggle-checkbox

    )
  • 再番号付け:

    C-c C-r

    (

    markdown-ts-renumber-list

    )
  • 新しいアイテム追加:

    M-RET

ブロックとコード (Code Blocks)

• 挿入:

  C-c C-,

  キーを押した後、以下のキーで種類を選択。

  • `

    : フェンス付きコードブロック（言語タグ可）。

  • ~

    : ティルダフェンス。

  • q

    : 引用ブロック。

  • d

    : 区切り線。

  • t

    : テーブル。
• フォント化: 言語が指定されたコードブロックは、対応する言語のモードでフォント化されます。色がない場合は文法不足の可能性があります。
• コンテキスト表示: コードブロック内部では、

  M-x markdown-ts-code-block-in-context-mode

  を有効にすると、言語ごとの操作（TAB でインデント、言語キーなど）が可能になります。

テーブル (Tables)

• 挿入:

  C-c C-, t

  または

  M-x markdown-ts-table-insert-table

  。
• 内部操作: 専用モードに入るため、セル移動や行数調整が可能です。
  • セル移動:

    TAB

    ,

    S-TAB

    。
  • 行の挿入/削除:

    M-RET

    ,

    M-↓

    ,

    M-Shift-↓

    など。
  • 列の挿入/削除:

    M-→

    ,

    M-←

    ,

    M-Shift-→

    ,

    M-Shift-←

    など。
  • 整列 (Align):

    C-c C-t a

    。

リンクと画像

• リンク:

  [text](url)

  および

  [text][ref]

  。フラグメントリンク（

  #id

  ）も動作。
• 画像: インラインレンダリング。
  • 表示切り替え:

    C-c C-x C-v

    。
  • 設定:

    markdown-ts-image-max-width

    ,

    markdown-ts-display-remote-inline-images

    。

移動とナビゲーション

• 移動キー:
  • 次の見出し:

    C-c C-n

  • 前の見出し:

    C-c C-p

  • 親見出しへ:

    C-c C-u

  • コードブロック間移動:

    C-c C-v n

    /

    C-c C-v p

    。
• 折りたたみ:

  markdown-ts-default-folding

  で初期表示状態を制御可能。
• ビューモード:

  M-x markdown-ts-view-mode

  を実行すると、読み込み専用の簡素なナビゲーションモードになります。

目次 (TOC) とエクスポート

• 目次生成: HTML コメント形式で埋め込むことができます。
  • テンプレート挿入:

    M-x markdown-ts-toc-insert-template

  • 生成/更新/クリア:

    M-x markdown-ts-toc-generate

    ,

    M-x markdown-ts-toc-update-before-save-mode

    など。
• エクスポート: パンドック（Pandoc）などを介して PDF や HTML に変換可能です。
  • コンバーター指定なし：デフォルトのコンバータを使用。
  • 表示:

    markdown-ts-convert-display-function

    でブラウザに出力できます。

---

5. よくある問題と注意点

実験的機能について

• API と動作は変更される可能性があります。
• 次回のリリースで「実験的」というラベルが外られることを目指していますが、現時点では回避策（Workaround）が必要です。

バグの原因となる主な要因

1. 文法の共有: Tree-sitter の文法は外部資産です。Emacs 内のバグではなく、共有リポジトリ側の仕様や不具合の影響を受けます。
2. ビルド環境: 事前コンパイルされたパッケージがなくても、ソースからコンパイルできます。ただし、

   make

   や C コンパイラが必要です。Node.js を必要とする文法もあるため注意が必要です。
3. 間接バッファ (Indirect Buffers):
   • Tree-sitter と間接バッファは相性が悪いです。
   • パーサーやフォント化（Font-lock）は共有されません。

   • markdown-ts-mode

     でも

     -ts-mode

     全般で、間接バッファ内のクローンにはフォント化が反映されない場合があります（Emacs の制限のため）。

バグ報告について

問題が発生した場合、Emacs 自体のバグではなく、以下のケースが多いです。

• 文法の解析ロジックの問題。
• Tree-sitter エコシステム側の問題。
• Emacs と Tree-sitter の統合の問題。

報告時は

M-x report-emacs-bug RET

を使用し、最小で再現可能な例を含めることを推奨します。特にフォント化、文法インストール、テーブル機能、他のモードとの相性に関する情報は重要です。

---

まとめ：ぜひ試してみてください

markdown-ts-mode

はまだ進化途中ですが、非常に強力なツールです。実験的というラベルに囚われず、以下のように利用することをお勧めします。

• Markdown ファイルで試す：異なる機能や設定を遊び倒し、改善点を発見しましょう。
• フィードバックを送る：問題があれば、Emacs 開発者ではなく

  markdown-ts-mode

  のメンテナに報告してください。
• 制限点との付き合い方：回避策を考えたり、文法のバージョンアップに対応したりするプロセスに参加することで、より安定した環境を作ることができます。

「準備万端」かどうかは関係なく、このモードの可能性を開発者と共有し合うことで、Emacs の Markdown エディタ体験は確実に向上していきます。