MDファイル(.md)とは 開き方・作り方・書き方と、AIがMDファイルを使う理由・CLAUDE.mdなどの代表例【2026年11月】

更新日:著者:AITECH編集局

監修:株式会社AITECH CEO

小森谷 祐太

監修:株式会社AITECH

AITECH編集局

  1. トップ
  2. COACH AI
  3. コラム
  4. MDファイル(.md)とは 開き方・作り方・書き方と、A…

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」が付きます。中身は文字だけで、行の頭に「#」を付けると見出し、「-」を付けると箇条書き、というように記号で書式を表します。

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のテキストエディットなど、パソコンに入っているテキストエディタ(文字だけのファイルを編集するアプリ)で開けます。見出しや太字の形で読みたいときは、マークダウンに対応したアプリで開きます。

MDファイルの開き方:パソコンに入っているテキストエディタで開ける。見出しや太字の形で読むには対応したアプリで開く
開くアプリ表示向いている使い方
テキストエディット(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ファイルとして書き出すこともできます。

MDファイルの作り方:テキストエディタで書き、名前の最後を「.md」にして保存する
作り方手順
テキストエディタで書くメモ帳・テキストエディット・Visual Studio Codeなどで書き、名前の最後を「.md」にして保存する
Googleドキュメントから書き出す「ファイル」の「ダウンロード」で「マークダウン(.md)」を選ぶ
AIに書かせるChatGPTやClaudeに「マークダウンで書いて」と頼み、返ってきた文章をテキストエディタに貼って保存する

Googleドキュメントの書き出しでは、見出しや箇条書きがマークダウンの記号に変わったMDファイルがダウンロードされます(Googleドキュメント エディタ ヘルプ)。

テキストエディタで保存したときは、保存したファイルの名前の最後が「.md」になっているかを確かめます。アプリの設定によっては、「手順書.md.txt」のように別の拡張子が後ろに付くことがあります。

MDファイルの書き方

MDファイルでよく使う書き方は、見出し・箇条書き・番号付きリスト・太字・リンク・引用の6つです。どれも、行の頭か文字の前後に記号を付けるだけです。

MDファイルの書き方:行の頭か文字の前後に記号を付けると、対応したアプリで書式に変わる

次の表は、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ファイルである理由:ClaudeCode・Codex・AIのスキルは、指示書の形式として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用の代表的なMDファイル:CLAUDE.md・AGENTS.md・SKILL.mdは、AIに作業の決まりや手順を伝える指示書
ファイル読むAIのツール書くこと
CLAUDE.mdClaude Code毎回の作業で守ってほしい決まり。毎回の作業の開始時に読まれる
AGENTS.mdCodex・Jules・Devin・Visual Studio Codeなど作業の手順や決まり。多くのAIのツールで共通に使える
SKILL.mdClaude・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ファイルの仕事での使い方:手順書・議事録・資料をMDファイルで書き、見出しで内容を分けてからAIに渡す
使い方MDファイルにするものAIに頼むこと
手順書を渡す見積書の作り方・問い合わせへの返信の決まり手順書に沿って作業させる
議事録を渡す会議の文字起こし・議事録決まったことと次の作業を抜き出させる
資料を書かせる提案書や報告書の下書きマークダウンで書かせ、MDファイルで保存する

AI受託やAIコンサルの仕事では、顧客の業務の手順を聞き取り、AIに渡す指示書としてMDファイルにまとめる作業があります。

Claude Code・Codexなどのツールを、AI受託の仕事に使える形で学べます
無料カウンセリングを予約する

Claude Code・Codexを学べる講座

Claude Code・Codexの使い方は、実践の講義があるAIスクールで学べます。仕事に使うには、ツールの使い方に加えて、AIに任せる業務を選び、AIの作業を確かめる方法を決める力が要ります。

ClaudeCode・Codexを学べる講座:仕事に使うには、ツールの使い方に加えて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ファイルの要点: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ファイルの利点です。

出典

この記事の内容は、2026年11月13日に各社の公式ページで確認しました。アプリの画面や機能は変わることがあるため、使う前に公式のページで確認してください(更新日:2026年11月13日・監修:株式会社AITECH CEO 小森谷 祐太)。

この記事の監修者

株式会社AITECH CEO

小森谷 祐太

新卒でSEとしてキャリアをスタート。エンジニア育成スクール「COACH TECH」の認定講師を務める。2025年に株式会社AITECHを創業し、CEOに就任。AIエージェント開発、業務自動化支援を行う。AIコンサルタント養成講座「COACH AI」を運営。

プロフィールを見る

株式会社AITECH

AITECH編集局

AIエージェントの構築・業務自動化の支援、AIコンサルタント養成講座「COACH AI」の運営を行う株式会社AITECHの編集局。

会社サイトを見る

Column

一覧を見る

Contact

AIエージェントの構築、業務自動化、AITECHコンサルティング・AITECH認定パートナーのご相談、取材・登壇のご依頼など、お気軽にご相談ください。