Markdownは、見出し、箇条書き、リンク、表、コードブロックなどを普通のテキストで書きやすくする軽量マークアップ記法です。
拡張子は .md がよく使われ、README、技術メモ、設計メモ、AIツール向けの指示ファイルなどで広く使われます。
まず押さえたいポイント
- テキストファイルなのでGitで差分管理しやすい
- 人間にも読みやすく、AIにも構造を渡しやすい
- 見出し、箇条書き、コード例、リンクを書きやすい
- READMEやAGENTS.md、CLAUDE.mdのようなAI向け指示ファイルにも使われる
どんな場面で使うか
開発現場では、README.md、CHANGELOG.md、設計メモ、議事録、APIメモ、ナレッジ共有などに使われます。
最近はAIコーディングツールにプロジェクトの前提や作業ルールを伝えるために、Markdownファイルを用意するケースも増えています。
たとえば、プロジェクト概要、テストコマンド、触ってはいけないファイル、本番反映手順をMarkdownで書いておくと、AIにも人間にも読みやすい説明書になります。
よくある誤解
Markdownはプログラミング言語ではありません。
また、Markdownを書けば必ず見た目が同じになるわけでもありません。GitHub、エディタ、ブログエンジンなど、表示する側の実装によって対応する記法や見え方が少し変わることがあります。
AIツールで使う場合も、Markdownの見た目より中身が重要です。
きれいな装飾を増やすより、見出しで整理し、箇条書きで具体的なルールを書き、必要なコマンドをコードブロックで示す方が役に立ちます。
実務で見るポイント
MarkdownファイルをAI向けの指示書として使うなら、長くしすぎないことが大事です。
古い仕様や不要な説明を詰め込むと、AIが重要なルールを拾いにくくなります。
詳しくは、AIコーディングで使うmdファイルとは？AGENTS.md・CLAUDE.md・指示書の役割を整理 で、AIツールとMarkdownファイルの関係を整理しています。