Notionで AI リーダビリティを向上させるためにすべきこと
maniはじめに
こんにちは。Belong でソフトウェアエンジニアをしている mani です。 本記事では、Notion にドキュメントを書く際に AI リーダビリティの向上のために意識すべきポイントについて解説します。
最近、エンジニアのための AI に伝わるドキュメントの基本 を読んで、AI リーダビリティの重要性を改めて認識しました。弊社としては Notion を使ってドキュメント管理をしているので、Notion で AI リーダビリティを向上するためにどのような工夫ができるかを考えたので、本記事で共有したいと思います。
AI リーダビリティとは
AI リーダビリティとは、AI が文章を理解しやすいかどうかを指す概念です。 2026年現在、AI の台頭により、文章を AI が読んだり書いたりする機会が増えています。そのため、AI が理解しやすいように文章を構成することが重要になっています。
AI は書いてある内容をそのまま理解しようとします。そのため、文章が曖昧だったり、文脈が不明瞭だったりすると、正確に理解できない可能性があります。AI リーダビリティの向上を意識することで、AI が文章を正確に理解しやすくなります。
AI リーダビリティを意識した Notion ドキュメント作成のポイント
僕自身が考えた Notion での AI リーダビリティ向上のためのポイントは以下の通りです。
- 見出しを適切に使う
- 画像にキャプションをつける
- ページリンクは文字にURLを埋め込む
- ライティングガイドラインを作成する
見出しを適切に使う
見出しを適切に使うためにはいくつかポイントがあります。
見出しの階層をh2から始める
Markdown 記法における見出しはh1から始まるのが一般的ですが、Notion ではページタイトルが自動的にh1として扱われるため、本文中の見出しはh2から始めるのが望ましいです。
見出しが同じ大きさのものは同じレベルの内容であるべきです。h1がタイトルで使われている以上、タイトルレベルで同じ意味を持つような内容があればh1で書くのではなく、別のページに書きましょう。
1つの見出しに1つの内容にする
AI が文章を検索する際に、1つの見出しに複数の内容が含まれていると、どの情報がどの見出しに対応しているのか判断しづらくなります。そのため、1つの見出しには1つの内容を対応させることが望ましいです。
--- NG 例
## インストールと初期設定
→ 初期設定を知りたいのにインストール方法まで読み取ってしまう
--- OK 例
## インストール手順
## 初期設定手順
→ 知りたい情報のみを取得できる
見出しを具体的な内容にする
見出しを具体的な内容にすることにより、AI による検索の精度に寄与します。冗長に見えるかもしれませんが、AI リーダビリティのためにも実施すべきだと思います。
--- NG 例
## ユーザーAPIの仕様
### 概要
### パラメータ
→ ユーザーAPI のパラメータを知りたいのに、見出しに直接引っかからない
--- OK 例
## ユーザーAPIの仕様
### ユーザーAPIの概要
### ユーザーAPIのパラメータ
→ ユーザーAPI のパラメータを知りたい場合に、見出しから直接情報にアクセスできる
画像にキャプションをつける
Notion 上の画像を取得する際、AI はこの画像がどういった画像かを読み取ることができません。そのため、画像にキャプションをつけることで、AI が画像の内容を理解しやすくなります。
例えば、システムのアーキテクチャ図を取得したいのに、キャプションがないと、アーキテクチャページにあるどの画像がアーキテクチャ図なのかを判断できません。そのため、AIは前後の文章を読み取って、この画像がアーキテクチャ図だと推測をして読み取りを行います。こういった事象を避けるために、画像には必ずキャプションをつけるようにしましょう。
ページリンクは文字にURLを埋め込む
Notion でページリンクを貼る方法としては、
- メンション
- URLのまま貼る
- 文字に埋め込む
の方法があるかと思います。推奨したいのは、文字に埋め込む形のリンクです。理由としては、AI が読み込んだときのデータ形式にあります。
文字に埋め込む場合
[リンク文字](url...)
メンションの場合
<mention-page url="url..."/>
メンション機能は Notion 特有の機能ではありますが、URL しか読み取れない状態になってしまいます。AI が正確にリンク先の情報を理解するためにも、文字に埋め込む形のリンクを使用することが推奨されます。
ライティングガイドラインを作成する
ライティングガイドラインを作成することで、AI や人間がドキュメントを作成する際に、統一された形式で記述することができるので、AI リーダビリティの向上に寄与します。
本記事で取り上げた内容に、チーム独自のルールを加えてガイドラインにしておくことで、AI リーダビリティが高く一貫性のあるドキュメントを継続的に作成できます。
まとめ
本記事では、Notion における見出しの使い方・画像のキャプション・リンクの貼り方・ライティングガイドラインの4点を紹介しました。
AI が台頭してきた昨今、AI を使ったドキュメントの作成・読み取りは必ず発生するでしょう。そのため、AI が読みやすくなるような取り組み、すなわち AI リーダビリティを意識したドキュメント作成は非常に重要です。本記事で紹介したポイントを参考に、AI にとっても人間にとっても理解しやすいドキュメントを作成していきましょう。
弊社 Belong は一緒に働くエンジニアを募集しています。
興味がある方は Belong Engineering Careers ページ をご覧いただけると幸いです。