この章では、少し軽い話題に移ります。あなたが毎日使っているかもしれないけれど、名前を知らないかもしれないもの、Markdownについてです。
まずは大胆な主張から始めます。
Markdownは、AI時代に学ぶべき最も重要なフォーマットです。
なぜか？ 読み進めてください。
Markdownとは？
一言で言うと、Markdownは記号を使って書式を制御するプレーンテキストの書き方です。
プレーンテキストには書式がありません。見出しも、太字も、リストもありません。一方、Wordのようなリッチテキスト形式は重すぎます。専用ソフトが必要で、ファイルサイズも大きくなります。
Markdownは「ちょうどいい」中間地点です。いくつかの簡単な記号を使うだけで、プレーンテキストに書式を追加できます。
例えば、次のように書くと：
# This is a heading
**This is bold**
- This is a list
これは、書式付きの見出し、太字テキスト、リストとして表示されます。とても簡単です。
なぜAI時代にMarkdownを学ぶべきなのか
理由1: AIはMarkdownを話す
ChatGPT、Claude、GeminiなどのAIが返信するとき、自動的に太字、見出し、リスト、コードブロックが含まれていることに気づいたことはありますか？
それがMarkdownです。
AIはWord文書やPDFを出力しません。デフォルトの出力形式はMarkdownです。このチュートリアルで見られるすべての表、太字、コードブロックは、すべてMarkdownです。
Markdownを学ばないということは、相手と話しているのに相手が書く言葉を理解しないようなものです。それでもコミュニケーションは取れますか？ はい。しかし、効率は格段に悪くなります。
理由2: どこにでもある
Markdownは特定のソフトウェア専用の形式ではなく、普遍的な標準です。Markdownをサポートするツールは数え切れません。
| カテゴリ | ソフトウェア/プラットフォーム |
|---|---|
| ノート作成 | Obsidian、Notion、Typora、Bear |
| コードプラットフォーム | GitHub、GitLab、Bitbucket |
| ブログシステム | Hugo、Jekyll、Hexo |
| ドキュメントツール | Confluence、Feishu Docs、Yuque |
| AIツール | ChatGPT、Claude、Gemini、Claude Code、Codex |
1つの形式を学べば、どこでも使えます。 Obsidianで書いたメモは、GitHubにコピーしても書式が保持されます。AIに渡せば、完璧に理解します。Wordで同じことを試してみてください。
理由3: ファイルサイズが驚くほど小さい
驚くかもしれませんが、同じ内容の場合、MarkdownファイルはWordファイルの20分の1以下のサイズです。
なぜか？ Wordの.docxファイルは、本質的にはXMLファイルを圧縮したアーカイブで、スタイル定義、フォント情報、ドキュメントプロパティが詰め込まれています。たった1行書いただけでも、ファイルサイズは数十KBになります。
Markdownはプレーンテキストです。ファイルサイズは書いたテキストの量に等しく、余分なものは一切ありません。
これはAIのシナリオで特に重要です。 文書をAIに送って分析してもらうとき、Markdownは消費するトークンが少なく、処理が速く、コストも低くなります。Wordファイル内のXMLタグやスタイル定義はすべてトークンとしてカウントされ、無駄になります。
理由4: AIはMarkdownをよりよく理解する
多くの人が知らないことです。
AIにWord文書を与えると、まずテキストに変換する必要があります。変換中に書式が失われたり、表の配置がずれたり、画像が消えたりすることがあります。
AIにMarkdownファイルを与えると、そのまま読み取ります。Markdownはそれ自体がプレーンテキストなので、変換は不要で、損失はゼロです。
さらに重要なのは、Markdownの記号（#を使った見出し、-を使ったリスト、`を使ったコード）は、AIにとって明確な構造の手がかりとなることです。AIはこれらの記号を認識し、文書の階層構造を理解し、各部分の重要性を判断します。
10分でMarkdownをマスターする
Markdownの構文は非常に少なく、直感的です。ここでは、最もよく使う構文を素早く紹介します。
1. 見出し（6段階）
``` ``) inherently tell the AI, “this is a heading, this is a list, this is code.” The AI can understand your content structure more accurately.
Learn Markdown in 10 Minutes
There are only about a dozen Markdown syntax elements, and even fewer are needed for daily use. Below, they are ordered by frequency of use, starting with the most common.
1. Headings
Use # followed by a space. The number of # symbols indicates the heading level:
### 2. テキストの装飾
For daily use, up to level 3 is enough.
2. Bold and Italic
### 3. リスト
**箇条書きリスト：**
Bold is used most often, italic occasionally.
3. Lists
Unordered lists use - or *:
**番号付きリスト：**
Ordered lists use numbers followed by a period:
**入れ子リスト：**
Lists can be nested by adding two spaces before the sub-item:
### 4. コード
**インラインコード：** バッククォートで囲む
4. Code
Inline code uses single backticks:
**コードブロック：** トリプルバッククォートで囲む
Result: Type claude --help to see help
Code blocks are wrapped with three backticks, and you can specify the language:
### 5. リンクと画像
```python
print("Hello World")
6. 引用
This is especially useful when communicating with AI. When sending code to an AI, wrap it in a code block so the AI can more accurately identify the code boundaries.
### 5. Links and Images
```
### 7. 表
```
Images are just links with a `!` in front.
### 6. Blockquotes
Start with `>`:
```
### 8. 水平線
```
Result:
> This is a blockquote.
> It can span multiple lines.
### 7. Tables
```
### 9. 取り消し線
```
Table syntax looks complex, but you don’t need to write it by hand. **Just ask the AI to generate it for you.** Say “organize this data into a table,” and the AI will output a Markdown table.
### 8. Horizontal Rules
Three or more `-` on a single line:
```
---
## AIとのコミュニケーションのヒント
### ヒント1: 見出しを使って構造化する
AIに長い文書を与えるときは、見出しを使って構造化しましょう。これにより、AIは文書の全体的な構成を素早く把握できます。
**悪い例：** 見出しのないテキストの塊
**良い例：**
```
Used to separate different sections of an article.
### 9. Strikethrough
```
### ヒント2: コードはコードブロックで囲む
コードについて質問するときは、必ずコードブロックで囲み、言語を指定してください。これにより、AIは構文を正確に認識できます。
```
Result: ~~Deleted text~~
---
## That’s Enough, Really
The 9 syntax elements above cover 99% of daily use cases.
**You don’t need to master Markdown.** Headings, bold, lists, and code blocks—master these four and you can handle most situations. Look up the rest when needed.
And Markdown has one advantage: **It’s okay if you can’t remember it all now; you’ll learn it by using it.** AI outputs Markdown, so as you read AI responses every day, you’ll naturally become familiar with these symbols.
---
## How to Use Markdown to Improve Communication with AI
After learning Markdown, here are a few tips to make your conversations with AI more effective:
**Tip 1: Use headings to structure your input**
```
### ヒント3: リストを使って要件を明確にする
複数の要件がある場合は、リストを使って整理しましょう。
```
Much better than a big block of text. With headings, the AI can more accurately understand the structure of your request.
**Tip 2: Wrap code in code blocks**
Don’t just paste code directly; wrap it in a code block:
ヒント4: 完全な構文（9つで99%をカバー）：リンク、画像、引用、表、水平線
ヒント5: AIとのコミュニケーションのコツ：見出しで構造化、コードはコードブロックで、要件はリストで
重要なポイント：
- MarkdownはAIの「母国語」です。学ぶことは、AIと効率的にコミュニケーションすることを意味します。
- 基本は10分で学べ、残りは必要に応じて調べましょう。
- わざわざ練習する必要はありません。AIを使いながら自然に身につきます。