Markdownとは？

まず答え

Markdown（マークダウン）は、普通のテキストに小さな記号を足して、見出し、太字、リスト、リンク、表などの構造を表す書き方です。ファイルはただのテキストなので、VS Code、メモアプリ、GitHub、ChatGPTなど多くの場所で扱えます。

# 会議メモ

今日は **検索改善** について話しました。

- 課題を整理する
- 次の担当者を決める
- 来週までに確認する

.mdファイルとは

Markdownで書かれたファイルは、よく .md という拡張子で保存されます。たとえば README.md、notes.md、report.md のような名前です。

.md ファイルの中身は特別なバイナリではなく、普通の文字です。そのため、特定のアプリがなくても開けます。長く残したいメモ、仕様書、手順書、AIに渡す資料に向いています。

よく使う記法

基本は少しだけ覚えれば十分です。

やりたいこと	Markdown
見出し	# タイトル
太字	**重要**
箇条書き	- 項目
リンク	[表示名](URL)
コード	`code`
表	`

最初から全部覚える必要はありません。よく使うものをコピーしながら覚えれば十分です。

Markdownはプログラミング言語ではない

Markdownはプログラムを書く言語ではありません。HTMLのようにWebページを細かく制御するものでもありません。

目的は、文章に「ここは見出し」「ここはリスト」「ここは表」という構造を付けることです。だから、読みやすさと扱いやすさのバランスがよく、ドキュメントに向いています。

AIに向いている理由

AIは見た目の装飾よりも、文章の構造を読みます。Markdownなら、見出し、段落、箇条書き、表、コードブロックが文字としてはっきり残ります。

PDFからコピーした文章は、改行、ヘッダー、フッター、表の列が崩れることがあります。Markdownに整えると、AIはどこがタイトルで、どこが手順で、どこが表なのかを推測しなくて済みます。

悪い入力:

Q3 売上 地域 北 1240 南 920 東 1510

良い入力:

| 地域 | Q3売上 |
|---|---:|
| 北 | 1,240 |
| 南 | 920 |
| 東 | 1,510 |

「値下げ」のマークダウンとは別です

日本語で「マークダウン」と言うと、商品を値下げする意味で使われることもあります。このページで扱うMarkdownは、文章を書くための記法です。

検索するときは、Markdown 記法、Markdown とは、Markdown 表 のように調べると、文章記法としての情報を見つけやすくなります。

いつ使うと便利か

• READMEや仕様書を書く。
• 会議メモや学習ノートを残す。
• PDFやWebページの内容をAIに渡す前に整理する。
• コードやコマンドを崩さず共有する。
• 長い文章を見出しと箇条書きで読みやすくする。

Markdownは、文章を「人間にもAIにも読みやすい形」にするための軽い共通形式です。

ヒント

はじめてなら、まず Markdownチートシート を開いて、よく使う記法だけコピーして試してください。

次に読む

• AIのためのMarkdown — AIに読ませる文書でMarkdownが効く理由。
• Markdownの表 — AIが読み間違えやすい表の整え方。
• VS CodeでMarkdownをプレビュー — 書いたMarkdownの見え方を確認する方法。