AIのMarkdownで目が滑る？mdechoで読みやすくして返信！
AI時代の到来で、 読むMarkdownの量が増えました 。以前書いた記事AIに読みやすい文章を書かせるためのスキルなど 2026年9月版のように「読みやすい文章を書かせる」のは前提として、それでも まぁまぁしんどい です。
そのしんどさを解消するために作ったツールmdechoを紹介します。
## 目が滑る
「Markdownはレンダリングせずすんなり読めるな〜」と思ってたんですが、読む量が増えたらそんなことは言ってられなくなりました。
以前は、NeovimでMarkdownをいい感じに表示するプラグインを使っていました。ただターミナルだと限界がありました。
- AIに指示するとき、「xx.mdのn行目の〜」「
xxxの見出しは〜」のように 参照先を自分で書いていた - 作業で言ったり来たりするとどこを読んでいたのか忘れる
- 余白を柔軟に調整できないので どこまでが同じ塊か分かりづらい
- テーブルなどが見づらく幅が調整できない
一方で単にMarkdownをレンダリングするだけだとNeovimで読むのと違って「カーソル行」が無いため、 どこを読んでいるのか分かりづらかった です。
## mdechoとは
というわけでこれらを解消するツールmdechoを作りました。
昨今溢れているコードレビューツールのMarkdown特化版みたいなツールです。
### ざっくり使い方
Markdownをブラウザでレンダリングし、クリックでコメントをつけます。
↓こんな感じでファイル名と行をクリップボード経由でAIに返信できます。 参照先を自分で書く手間がなくなります 。
README.md:L5`CLIから実行する`って何？
---
README.md:L12これもっと新しいの出てなかったっけ？選択箇所をコメントで引用もできます。
Markdownでいう「引用」は> hogeの記法ですが、AIに聞く時は「〇〇って何？」のような そのまま文を続ける書き方 が多いです。なのでインラインコードにしました。
### 今読んでいる行が分かる
「他のAIからの通知」「Slackでの人間からの連絡」など、「今の作業を中断し、しばらくしてから戻ってくるケース」が多々あります。
そんなときに エディタのようにカーソル行があれば分かりやすい と思ったので付けました。
キーボードの↓↑キーだけでなくjkにも対応してます。
### 1行に詰め込まれた文を分割して表示
AIが書いた文章は、改行無しでの複数の文（しかも人間より多い）がありがちです（筆者的には）。
スキルで改善するのが一番です。ただそのままレンダリングすると 「このコメントどの部分に対してだっけ？」「さっき読んでた行は分かるけどどの部分？」 となります。
これを解消すべく、オプションで「句点。で改行させ、一文ずつ表示する」という設定をつけました。
画像の例では、67行目が。を元に2行に分割しています。
### 行間でどこまでが同じ塊か分かる
行間を調整して、どこまでが同じ塊なのか分かるようにしました。
左が調整なしのレンダリング、右がmdechoでの調整結果です。
（ブログの実装的に画像が見づらくて申し訳ないですが、）「リストの各要素の間の余白」を調整したり、ネストの場合に線を引いて可視化したりしてます。
他にも段落や見出し、日本語の折り返しなどに手を入れてます。
### テーブルを広く見られる
AIがパッとテーブルを書いてくれるのは便利ですが、 カラム数が多くなると折り返しが多くて読みづらくなりがち です。
なのでテーブルは拡大して見られるようにしました。カラム幅も調整できます。
よくある1行ごとに背景色変えるやつもやってます。
## インストール
npmで配布しているのでnpxで実行してください（どうせAIに聞くんですよね）。
npx mdecho --file README.md## そもそも全部Markdownを使うわけではない
なんでもかんでもAIにMarkdownで書かせているわけではありません。以前紹介したeli5のスキルを使い、HTMLで整理してもらうことも多いです。
全体像が知りたいんだよォー！そんな時は図解スキルeli5が便利 | eiji.page
適材適所で使いましょう。
以上、自作ツールmdechoの紹介でした。「ブラウザで開いてクリップボード経由でAIにフィードバックしよう」という発想はdifitにめちゃくちゃ影響を受けています。感謝！
まだ使ったことない人は使ってみてください。
AIのコード全部チェックしてる？difitで『目が滑る』問題を解決 | eiji.page
前回の記事が無断転載されてたのでいろいろモチベ下がってたんですが、また少しずつ書けるようになるといいなという気持ち。