この記事でわかること
- mdファイル(.md)とは何か——記号で手軽に書ける「素のテキストファイル」だということ
- mdファイルの開き方・作り方(メモ帳・テキストエディット・スマホでもOK)
- txtファイル・Wordとの違いと、AIへの指示書(CLAUDE.md)としての活用
「自社の業務をAIに任せたい」という方はこちら
AIサービスの詳細・無料相談はこちら →Claude Codeに挑戦しようとしている方、あるいは挑戦している方であれば一度は耳にするmdファイル。
mdファイル(.md)とは、文章を記号で手軽に整えられる「Markdown(マークダウン)」形式で書かれた、拡張子が.mdのテキストファイルです。
メモ帳のような素のテキストなので、特別なソフトがなくても開けて、作るのも簡単です。
この記事では、まずmdファイルの意味・開き方・作り方・txtやWordとの違いをやさしく解説し、後半で近年注目される「AIへの指示書(CLAUDE.md)」としての使い方まで紹介します。
mdファイル(.md)とは?意味をやさしく解説
mdファイル(.md)とは、「Markdown(マークダウン)」という書き方で書かれた、拡張子が「.md」のテキストファイルです。
「#」で見出し、「-」で箇条書き、というように記号を使って文章の構造を手軽に表せるのが特徴です。
見た目はほぼ普通のメモ書きで、特別なソフトも専門知識もいりません。
WordやPDFと違い、飾りのない”素のテキスト”なので、ファイルが軽く、どんな環境でも開きやすいのが利点です。
そのシンプルさから、エンジニアの世界では説明書(README)やメモとして昔から広く使われてきました。
そして近年は、AIへの指示書としても使われるようになっています(後半で解説します)。
mdファイル(.md)の開き方
mdファイルは、特別なアプリがなくても開けます。
お使いの環境ごとの開き方は次のとおりです。
| 環境 | 開き方 |
|---|---|
| Windows | 「メモ帳」で開ける。右クリック →「プログラムから開く」でメモ帳を選択 |
| Mac | 「テキストエディット」でそのまま開ける |
| スマホ(iPhone / Android) | 標準の「メモ」「ファイル」アプリや、無料のテキストエディタアプリで開ける |
| きれいに表示したい | VS Code・Typora・Obsidianなら、見出しや箇条書きが整って表示される |
「とりあえず中身を見たいだけ」なら、ファイルを右クリック →「プログラムから開く」でメモ帳やテキストエディットを選べばOKです。
難しく考えず、まずは普段のテキストエディタで開いてみてください。
mdファイル(.md)の作り方
作り方もかんたんで、テキストファイルを拡張子「.md」で保存するだけです。
- メモ帳やテキストエディットを開く
- 「# タイトル」「- 箇条書き」のように本文を書く
- 保存するとき、ファイル名を「example.md」のように拡張子.mdで保存する
これだけでmdファイルの完成です。
専用ソフトや難しい設定は一切いりません。
まずは1つ作ってみると、「ただのテキストなんだ」と実感できるはずです。
mdファイル(.md)とtxt・Wordファイルの違い
「txtファイルやWordと何が違うの?」と気になる方も多いはずです。
ざっくり整理すると、次のような違いがあります。
| 種類 | 特徴 | 向いている用途 |
|---|---|---|
| .md(Markdown) | 記号で見出し・箇条書きを表せる素のテキスト。軽い | メモ・説明書・AIへの指示書 |
| .txt(テキスト) | 本当に飾りのない文字だけ。構造は付けられない | 単純なメモ書き |
| .docx(Word) | フォント・色・レイアウトを細かく装飾できる。ファイルは重め | 印刷物・体裁を整えた書類 |
簡単に言うと、.mdは「txtの手軽さ」と「見出しなどの構造」をいいとこ取りした形式です。
装飾は最小限ですが、そのぶん軽くてどこでも開け、人にもAIにも読み取りやすいのが強みです。
Claude CodeでのMDファイル「CLAUDE.md」の役割
ここからは、いま注目されている使い方、AIへの指示書としてのmdファイルを見ていきます。
Claude Codeの世界では、このMDファイルに「AIにやってほしいこと」を書いておくという使い方をします。
その中心になるのが、プロジェクトの指示書である「CLAUDE.md」というファイルです。
Claude Codeは作業を始めるとき、まずこのCLAUDE.mdを読み込み、そこに書かれたルールに沿って動いてくれます。
イメージは、新しく入った社員さんに渡す”業務マニュアル”です。
毎回ゼロから口頭で説明する代わりに、一度マニュアルを作っておけば、誰が作業しても同じ品質で動けます。
「それなら普通のメモ帳やWordでもいいのでは?」と思うかもしれません。
MDファイルが選ばれるのは、軽くてAIが正確に読み取りやすく、後から少しずつ直したり、チームで共有したりしやすいからです。
飾りのない素のテキストだからこそ、AIにとっての”読みやすい指示書”になります。
CLAUDE.mdには何を書く?(5つの基本要素)
では、CLAUDE.mdには具体的に何を書けばいいのでしょうか。
難しく考える必要はありません。
次の5つの要素を押さえておけば、それだけで立派な指示書になります。
| 書く要素 | 内容の例 |
|---|---|
| ① プロジェクトの概要 | 何のための作業か(例:自社ブログ記事の作成) |
| ② 前提・使うツール | WordPressを使う、Notionと連携している、など |
| ③ やってほしいこと | 記事は結論から書く、見出しを付ける、など |
| ④ やってほしくないこと | 勝手に公開しない、専門用語を多用しない、など |
| ⑤ 口調・出力のルール | ですます調で、日本語で回答する、など |
たとえば、実際のCLAUDE.mdはこんなイメージです。
専門的な記号はほとんどなく、普通の文章で書けることが分かります。
# このプロジェクトについて
自社ブログ(WordPress)の記事を作成するためのプロジェクトです。
## やってほしいこと
- 記事は結論から先に書く
- 見出しを付けて読みやすくする
- 専門用語には一言で補足を入れる
## やってほしくないこと
- 私の確認なしに記事を公開しない
## 口調・ルール
- ですます調で、日本語で回答する
このように、「どんな作業を」「どう進めてほしいか」を日本語で書くだけです。
最初から完璧を目指す必要はなく、まずは概要と「やってほしいこと」を数行書くところから始めれば十分です。
どう運用する?プロジェクト管理の「3点セット」
CLAUDE.md1枚でも十分役立ちますが、プロジェクトが大きくなってきたら、役割の違うMDファイルを組み合わせると管理がぐっと楽になります。
弊社Orcaでも、次の「3点セット」で運用しています。
- ① 指示書(CLAUDE.md):基本ルールをまとめた、いわばマニュアル本体
- ② 現在地メモ:「今どこまで進んだか」「次に何をするか」を記録する、引き継ぎノートのような役割
- ③ 役割分担ファイル:「経理」「広報」「秘書」など、AIに持たせたい役割ごとのルールを分けて記録
こうしておくと、久しぶりに作業を再開しても、AIが「現在地メモ」を読んで前回の続きから動けます。
人の引き継ぎと同じで、”どこまでやったか”が残っていれば、毎回ゼロからのスタートにならずに済むのです。
なお、CLAUDE.mdは置く場所によって適用範囲が変わります。
パソコン全体に効かせたい共通ルールは「自分専用の設定フォルダ」に、特定のプロジェクトだけのルールは「そのプロジェクトのフォルダ」に置く、と使い分けます。
まずは1つのプロジェクトフォルダにCLAUDE.mdを1枚置くところから始めれば大丈夫です。
良いMDファイルを書く3つのコツ
同じことを伝えるMDファイルでも、書き方次第でAIの動きは大きく変わります。
意識したいのは次の3つです。
- 箇条書きで短く書く:長い文章より、1行ずつの箇条書きのほうがAIは正確に理解します
- 具体的に書く:「読みやすく」より「1文は短く、結論から書く」のように、行動できる言葉にする
- 書きっぱなしにせず更新する:作業で気づいたルールを少しずつ追記し、育てていく
たとえば「いい感じに書いて」では、AIも何を基準にすればいいか分かりません。
「結論を最初の段落に書く」「見出しを3つ以上付ける」のように、具体的な指示に言い換えるだけで、仕上がりが安定します。
これは、新人さんに「いい感じにやって」と言うより「この手順でやって」と伝えるほうが伝わるのと同じです。
よくある失敗と注意点
最後に、つまずきやすいポイントを先回りでお伝えします。
- 盛り込みすぎる:
あれもこれもと書きすぎると、かえって要点がぼやけます。最初は本当に大事なルールだけに絞りましょう - 抽象的すぎる:
「丁寧に」「いい感じに」だけでは伝わりません。具体的な行動に落とし込みます - 更新されず古くなる:
実態と合わなくなった指示書は、むしろAIを混乱させます。気づいたら直す習慣を - 機密情報を書かない:
パスワードや顧客の個人情報などはMDファイルに直接書かないでください。
社内のルールに沿って安全に扱いましょう。
まとめ・次のステップ
mdファイル(.md)は、記号で手軽に書ける”素のテキストファイル”です。
開き方も作り方もかんたんで、メモ帳やテキストエディット、スマホがあれば誰でも扱えます。
そしてClaude Codeでは、このmdファイル=CLAUDE.mdがAIに渡す”業務マニュアル”になり、一度書けば毎回同じ説明をせずに同じ品質で作業を任せられます。
最初の一歩としては、いま取り組んでいる作業のフォルダにCLAUDE.mdを1枚作り、概要と「やってほしいこと」を3行だけ書いてみてください。
使いながら少しずつ育てていけば、AIはどんどんあなたの仕事のやり方に合ってきます。
よくある質問(FAQ)
Q. .mdファイルとは何ですか?
A. 「Markdown(マークダウン)」という書き方で書かれた、拡張子が.mdのテキストファイルです。
記号で見出しや箇条書きを手軽に表せる、軽くてシンプルなファイルです。
Q. mdファイル(.md)の開き方は?
A. メモ帳やテキストエディットでそのまま開けます。
見出しなどを整った状態で見たい場合は、VS CodeやObsidianなどのアプリが便利です。
Q. mdファイルはスマホでも開けますか?
A. 開けます。
iPhoneやAndroidの標準の「メモ」「ファイル」アプリや、無料のテキストエディタアプリで中身を確認できます。
Q. mdファイルをWordやExcelで開けますか?
A. Wordでも開けますが、記号がそのまま文字として表示されます。
中身を読むだけならメモ帳やテキストエディットのほうが手軽です。
Q. mdファイルはどうやって作りますか?
A. テキストを書いて、ファイル名を「○○.md」と拡張子.mdで保存するだけです。
専用ソフトは不要で、メモ帳やテキストエディットで作れます。
Q. txtファイルとの違いは?
A. txtは飾りのない文字だけですが、.mdは記号で見出しや箇条書きの構造を付けられます。
軽さはそのままに、読みやすさを足したのが.mdです。
弊社では中小企業向けにAI活用支援を行っております。
「自社でもこういった仕組みを作りたい」「まず何から始めればいいかわからない」という方は、
お気軽にご相談ください。
コメント