MDファイル(.md)とは 開き方・作り方・書き方と、AIがMDファイルを使う理由・CLAUDE.mdなどの代表例【2026年11月】
更新日:著者:AITECH編集局

監修:株式会社AITECH CEO
監修:株式会社AITECH
AIを使っていると、「.md」で終わるファイルを渡されたり、作るように言われたりすることがあります。MDファイルとは、マークダウン(Markdown)という書き方で見出しや箇条書きを付けた、文字だけの文書のファイルです。
Claude CodeのCLAUDE.md、AIのスキルのSKILL.mdなど、AIに読ませる指示書の多くはMDファイルです。よく使う記号は6種類です。
この記事では、受け取ったMDファイルを読みやすい形で開く方法と、AIに渡す作業の手順を自分でMDファイルに書く方法が分かります。
この記事の結論
- MDファイルとは:マークダウンという書き方で見出しや箇条書きを付けた、文字だけの文書のファイル。名前の最後に「.md」が付く
- 開き方:テキストエディットや古い版のメモ帳では記号のまま、Googleドキュメントでは見出しや太字の形で読める
- 作り方:テキストエディタで書き、名前の最後を「.md」にして保存する。Googleドキュメントからも書き出せる
- 書き方:見出し・箇条書き・番号付きリスト・太字・リンク・引用の6つを、記号で書く
- AIとの関係:CLAUDE.md・AGENTS.md・SKILL.mdなど、AIに渡す指示書の多くはMDファイル
Claude Code・Codexなどのツールの使い方を、専属コーチとマンツーマンで学べます
無料カウンセリングを予約する
MDファイルとは
MDファイルとは、マークダウンという書き方で書いた文書を保存したファイルで、名前の最後に「.md」が付きます。中身は文字だけで、行の頭に「#」を付けると見出し、「-」を付けると箇条書き、というように記号で書式を表します。
マークダウンは、2004年にJohn Gruber氏がAaron Swartz氏と協力して作った書き方です(CommonMark、2026年11月13日確認)。作者のGruber氏は、マークダウンを「読みやすく書きやすい文字だけの形式で書き、Webページの形に変換できるもの」と説明しています(Daring Fireball「Markdown」)。
MDファイルは、記号を書いたままの状態でも読めます。対応したアプリで開くと、記号が見出しや太字の表示に変わります。
| ファイル | 中身 | 見出し・太字 |
|---|---|---|
| MDファイル(.md) | 文字だけ | 記号で書く。対応したアプリで表示が変わる |
| テキストファイル(.txt) | 文字だけ | 付けられない |
| Wordファイル(.docx) | 文字と書式の情報 | 画面のボタンで付ける。Wordなどの対応したアプリが要る |
MDファイルは、テキストファイルと同じく文字だけなので、どのパソコンでも開けます。そのうえで見出しや箇条書きの構造を残せる点が、テキストファイルとの違いです。
MDファイルの開き方
MDファイルは、Windowsのメモ帳やMacのテキストエディットなど、パソコンに入っているテキストエディタ(文字だけのファイルを編集するアプリ)で開けます。見出しや太字の形で読みたいときは、マークダウンに対応したアプリで開きます。
| 開くアプリ | 表示 | 向いている使い方 |
|---|---|---|
| テキストエディット(Mac) | 記号のまま | 中身を確かめる・少し直す |
| メモ帳(Windows) | 古い版は記号のまま。マークダウンの表示に対応した版では、書式つきの表示に切り替えられる | 中身を確かめる・少し直す |
| Googleドキュメント | 見出し・太字の形で表示される | 読みやすい形で読む・Googleドキュメントとして編集する |
| Visual Studio Code | 編集画面とプレビューを切り替えられる | 書きながら表示を確かめる |
Googleドキュメントでは、「ファイル」の「開く」から「アップロード」でMDファイルを選ぶと、ファイルがGoogleドキュメントとして開きます(Googleドキュメント エディタ ヘルプ)。
Visual Studio Code(Microsoftの無料のテキストエディタ)では、MDファイルを開いてWindowsはCtrl+Shift+V、Macは⇧⌘Vを押すと、プレビューに切り替わります(Markdown and Visual Studio Code)。
Windowsのメモ帳について、Microsoftは2025年5月に、マークダウンの書式で表示する機能を、Windowsの先行版を試す登録者(Windows Insider)向けに配信し始めたと発表しています。この機能のある版では、書式つきの表示と記号の表示を切り替えられます(Windows Insider Blog)。
MDファイルの作り方
MDファイルは、テキストエディタで書き、名前の最後を「.md」にして保存すれば作れます。Googleドキュメントで書いた文書を、MDファイルとして書き出すこともできます。
| 作り方 | 手順 |
|---|---|
| テキストエディタで書く | メモ帳・テキストエディット・Visual Studio Codeなどで書き、名前の最後を「.md」にして保存する |
| Googleドキュメントから書き出す | 「ファイル」の「ダウンロード」で「マークダウン(.md)」を選ぶ |
| AIに書かせる | ChatGPTやClaudeに「マークダウンで書いて」と頼み、返ってきた文章をテキストエディタに貼って保存する |
Googleドキュメントの書き出しでは、見出しや箇条書きがマークダウンの記号に変わったMDファイルがダウンロードされます(Googleドキュメント エディタ ヘルプ)。
テキストエディタで保存したときは、保存したファイルの名前の最後が「.md」になっているかを確かめます。アプリの設定によっては、「手順書.md.txt」のように別の拡張子が後ろに付くことがあります。
MDファイルの書き方
MDファイルでよく使う書き方は、見出し・箇条書き・番号付きリスト・太字・リンク・引用の6つです。どれも、行の頭か文字の前後に記号を付けるだけです。
次の表は、GitHubのマークダウンの説明にある書き方のうち、よく使うものです(GitHub Docs「基本的な書き込みと書式設定の構文」)。
| 書式 | 書き方 | 書いた例 |
|---|---|---|
| 見出し | 行の頭に「#」と空白。「##」「###」で小さい見出し | # 作業の手順 |
| 箇条書き | 行の頭に「-」と空白 | - 見積書を作る |
| 番号付きリスト | 行の頭に「1.」と空白 | 1. 顧客に確認する |
| 太字 | 文字の前後を「**」で囲む | **必ず確認する** |
| リンク | 表示する文字を [ ]、URLを ( ) で囲む | [会社のサイト](https://example.com) |
| 引用 | 行の頭に「>」と空白 | > 顧客の発言 |
表の「書いた例」の記号は、半角の文字で書きます。段落を分けるときは、空の行を1行入れます。
この記事を書いている株式会社AITECH(AI事業の立ち上げを学ぶスクール「COACH AI」の運営会社)では、コラムの書き方の決まりをMDファイルに書き、「構成」「画像・図」「文章」「公開前の確認」などの見出しで分けています。新しい決まりは、該当する見出しの下に書き足します。見出しで分けておくと、AIも人も、どこに何の決まりがあるかを探しやすくなります。
Claude Code・Codexを実際に使いながら、業務の自動化を学べます
無料カウンセリングを予約する
AIの指示書がMDファイルである理由
Claude Code・Codex・AIのスキルは、AIに渡す指示書の形式としてMDファイルを使っています。MDファイルは文字だけで書け、見出しと箇条書きで内容をまとめられます。
AIに渡す指示書をMDファイルで書く利点
- 形式:文字だけで書くため、専用のアプリがなくても人もAIも読める
- 構造:Claude Codeの公式ドキュメントは、見出しと箇条書きでまとめた指示は、長い段落よりもClaudeが従いやすいとしている
- 共通:同じ書き方で、CLAUDE.md・AGENTS.md・SKILL.mdを書ける
Claude Codeの公式ドキュメントは、CLAUDE.mdを「Claude に永続的な指示を与えるマークダウンファイル」と説明しています。Claudeは、すべての作業の開始時にこのファイルを読みます。同じドキュメントは、関連する指示を見出しと箇条書きの下にまとめると、密集した段落よりもClaudeが従いやすくなるとしています(Claude Code Docs「Claude はプロジェクトをどのように記憶するか」)。
株式会社AITECHでは、社内でAIを動かすときの決まりを複数のMDファイルに分けて書き、最初に読むCLAUDE.mdに、ほかのファイルを読む順番を書いています。決まりを変えるときは、該当するMDファイルだけを書き直します。
AI用の代表的なMDファイル
AIのツールが読む代表的なMDファイルは、CLAUDE.md・AGENTS.md・SKILL.mdの3つです。どれも、AIに作業の決まりや手順を伝えるための指示書です。
| ファイル | 読むAIのツール | 書くこと |
|---|---|---|
| CLAUDE.md | Claude Code | 毎回の作業で守ってほしい決まり。毎回の作業の開始時に読まれる |
| AGENTS.md | Codex・Jules・Devin・Visual Studio Codeなど | 作業の手順や決まり。多くのAIのツールで共通に使える |
| SKILL.md | Claude・Codexなど | 特定の作業の手順。その作業に関係するときだけ読まれる(Claude・Codex) |
CLAUDE.mdについて、Claude Codeの公式ドキュメントは、1つのファイルを200行以下にするよう勧めています。長いファイルはAIが一度に読める量(コンテキスト)を多く使い、指示が守られにくくなるためです。
AGENTS.mdは、OpenAIが始めた共通の指示書の形式です。2025年12月に、Linux Foundationが設立した団体「Agentic AI Foundation」に、AIと外部のツールをつなぐ規格のMCPとともに移管されました(Linux Foundationの発表)。Claude Codeも、CLAUDE.mdの代わりにAGENTS.mdを読めます。
SKILL.mdについてはAIのスキル(Agent Skills)の記事、指示書を含むAIの作業の仕組みはAIのハーネスの記事で紹介しています。
MDファイルの仕事での使い方
仕事でのMDファイルの使い方には、手順書や議事録をAIに渡す使い方と、資料をAIに書かせる使い方があります。AIに議事録や報告書を書かせるときも、マークダウンで出力させると、そのままMDファイルとして保存できます。
| 使い方 | MDファイルにするもの | AIに頼むこと |
|---|---|---|
| 手順書を渡す | 見積書の作り方・問い合わせへの返信の決まり | 手順書に沿って作業させる |
| 議事録を渡す | 会議の文字起こし・議事録 | 決まったことと次の作業を抜き出させる |
| 資料を書かせる | 提案書や報告書の下書き | マークダウンで書かせ、MDファイルで保存する |
AI受託やAIコンサルの仕事では、顧客の業務の手順を聞き取り、AIに渡す指示書としてMDファイルにまとめる作業があります。
Claude Code・Codexなどのツールを、AI受託の仕事に使える形で学べます
無料カウンセリングを予約する
Claude Code・Codexを学べる講座
Claude Code・Codexの使い方は、実践の講義があるAIスクールで学べます。仕事に使うには、ツールの使い方に加えて、AIに任せる業務を選び、AIの作業を確かめる方法を決める力が要ります。
COACH AIとは
COACH AIは、未経験・非エンジニアの方が、副業からAI受託・AIコンサル・AI顧問などのAI事業を立ち上げ、独立・事業化からM&Aまで目指せるよう、専属コーチがマンツーマンで伴走するスクールです。
プログラミング経験は不要で、ノーコードのツールから始められます。
COACH AIの動画教材には、Claude Code・Codex・n8n・Difyなどのツールの実践が含まれます(COACH AIのカリキュラム、2026年11月13日確認)。公式LINEで質問を受け付けています。詳しくはCOACH AIのページをご覧ください。
まとめ
MDファイルとは、マークダウンという書き方で見出しや箇条書きを付けた、文字だけの文書のファイルです。
- MDファイルはメモ帳やテキストエディットで開け、Googleドキュメントでは見出しや太字の形で読めます。
- 作るときは、テキストエディタで書き、名前の最後を「.md」にして保存します。
- よく使う書き方は、見出し・箇条書き・番号付きリスト・太字・リンク・引用の6つです。
- CLAUDE.md・AGENTS.md・SKILL.mdなど、AIに渡す指示書の多くはMDファイルです。
- Claude Codeの公式ドキュメントは、指示を見出しと箇条書きでまとめると、Claudeが従いやすくなるとしています。
最初にやることは、普段AIに説明している作業の手順を、見出しと箇条書きを付けて1つのMDファイルに書くことです。
よくある質問
MDファイルを開くと記号だらけで読みにくいのですが、どうすればよいですか?
テキストエディットや古い版のメモ帳では、記号のまま表示されます。Googleドキュメントにアップロードして開くか、Visual Studio Codeのプレビューに切り替えると、見出しや太字の形で読めます。
MDファイルをWordやPDFにできますか?
できます。MDファイルをGoogleドキュメントで開くと、Googleドキュメントの文書になります。そこから「ファイル」の「ダウンロード」で、WordやPDFの形式を選んで保存します。
ChatGPTやClaudeにMDファイルを渡すにはどうすればよいですか?
会話の入力欄にファイルを添付します。ファイルの中身を全部コピーして、入力欄に貼ることもできます。
WordのファイルとMDファイルのどちらでAIに渡すのがよいですか?
AIに渡すための文書を新しく作るなら、MDファイルで書くと、AIが書き直した結果を同じ形式で保存できます。CLAUDE.mdやSKILL.mdのように、AIのツールの指示書としてそのまま使える点もMDファイルの利点です。
出典
- Daring Fireball「Markdown」(John Gruber)
- CommonMark
- GitHub Docs「基本的な書き込みと書式設定の構文」
- Googleドキュメント エディタ ヘルプ「Google ドキュメント、スライド、図形描画でマークダウンを使用する」
- Visual Studio Code「Markdown and Visual Studio Code」
- Windows Insider Blog「Text Formatting in Notepad begin rolling out to Windows Insiders」(2025年5月30日)
- Claude Code Docs「Claude はプロジェクトをどのように記憶するか」
- AGENTS.md
- Claude Help Center「What are skills?」・OpenAI「Build skills」
- Linux Foundation「Linux Foundation Announces the Formation of the Agentic AI Foundation」(2025年12月9日)
この記事の内容は、2026年11月13日に各社の公式ページで確認しました。アプリの画面や機能は変わることがあるため、使う前に公式のページで確認してください(更新日:2026年11月13日・監修:株式会社AITECH CEO 小森谷 祐太)。




