---
title: textlintではじめる日本語文章校正 — Zedでも動くLSPサーバーを作りました
description: 日本語の文章をリアルタイムで校正するtextlintを、Zedエディタで使えるようにするLSPサーバーを自作しました。導入方法からルール設定、自動修正、無効化までを解説します。
---

## 作った理由

日本語の文章を書くとき、表記ゆれや誤字脱字のチェックに [textlint](https://textlint.github.io/) が便利です。しかし、愛用している [Zed](https://zed.dev/) エディタに拡張機能がなかったので、LSPサーバーを自作しました。

## 2つのプログラム

| 名前 | 役割 | 公開予定 |
|---|---|---|
| `textlint-lsp` | LSPサーバー本体。Node.jsで動作。どのエディタでも使える | npm に公開予定 |
| `zed-textlint` | Zed拡張機能。`textlint-lsp` を起動する | [zed-industries/extensions](https://github.com/zed-industries/extensions) にPR予定 |

LSPサーバーは汎用なので、VSCodeやNeovimなどほかのエディタでも動きます。

## できること

- 文字入力のたびに自動校正（結果はキャッシュされるので高速）
- 波線で問題箇所を表示
- `Ctrl+.` で修正候補を表示・適用
- ルール単位の無効化（行単位／全ルール）
- `prh.yml` による独自の表記ルール定義

## 導入方法

### 1. textlint-lsp をインストール

```bash
npm install -g textlint-lsp
```

### 2. プロジェクトにtextlintをセットアップ

```bash
npm install --save-dev textlint @textlint/markdown
npm install --save-dev @textlint-ja/no-synonyms prh
```

`.textlintrc.json` を作成：

```json
{
  "plugins": { "@textlint/markdown": true },
  "rules": {
    "@textlint-ja/no-synonyms": true,
    "prh": { "rulePaths": ["prh.yml"] }
  }
}
```

### 3. Zed拡張機能をインストール

#### 方法A：Zed拡張機能一覧から（PRマージ後）

Zedの拡張機能一覧に「textlint」が表示されたら、ワンクリックでインストールできます。

#### 方法B：Dev Extension として手動インストール

1. [zed-textlint.zip](/zed-textlint.zip) をダウンロードして展開
2. Zedで `Ctrl+Shift+P` → `zed: install dev extension` を実行
3. 展開した `zed-textlint` フォルダを指定

導入後、`.md` または `.mdx` ファイルを開くと自動的にlintが走ります。

## コードアクション（自動修正）

波線の上で `Ctrl+.` を押すと、次の操作が選べます。

| アクション | 内容 |
|---|---|
| 修正を適用 | textlintの自動修正候補を適用 |
| 無効化:（ルール名） | その行だけ指定ルールを無効化 |
| 無効化: すべてのルール | その行以降の全ルールを無効化 |

## 無効化コメント

`.md` ファイルではHTMLコメント形式で記述します。

- `<!-- textlint-disable prh -->` で無効化
- `<!-- textlint-enable prh -->` で再有効化

`.mdx` ファイル（Starlight / Astro）では、MDXの構文制約のため、`{/* */}` で囲みます。

- `{/* <!-- textlint-disable prh --> */}` で無効化
- `{/* <!-- textlint-enable prh --> */}` で再有効化

:::note
##### 📝 MDXでの注意点
Zedのコードアクションから自動挿入されるので、普段は手動で書く必要はありません。
:::

## 公開について

### `textlint-lsp`（LSPサーバー）

npmで公開済みです。`npm install -g textlint-lsp` でインストール可能です。

### `zed-textlint`（Zed拡張機能）

Zedの拡張機能一覧に掲載申請中です。公開までは [zed-textlint.zip](/zed-textlint.zip) をダウンロードし、Dev Extension としてインストールしてください。

## トラブルシューティング

### MDXファイルで `{ }` がエラーになる

Mermaid図の `{{ }}` がMDXパーサにJSX式と誤認されることがあります。`{{` を `(` に置き換えてください。

### lintが遅い

初回のlintには数秒かかりますが、結果はキャッシュされるため2回目以降は高速です。