マークダウン
Markdown
概要（サマリー）
見出しやリスト、強調などの文章構造を、簡単な記号で書ける軽量な記法のこと。
たとえば # 見出し や - リスト、**太字** のように、シンプルな記号を使うだけで文章を整理して書ける。
HTML のようにタグをたくさん書かなくても、見出し・箇条書き・リンク・表などを比較的わかりやすく表現できるのが特徴である。
Notion、Obsidian、GitHub、README、技術メモ、AIへの指示文など、現代の文章整理や開発メモで非常によく使われる。
人間にとっても比較的読みやすく、AIにも構造が伝わりやすいため、AI時代と特に相性のよい書き方の1つである。
詳細解説
マークダウン（Markdown）とは、文章の構造や装飾を、簡単な記号で表現するための書き方である。
「軽量マークアップ言語」などと説明されることもあるが、初心者向けにはまず、
“プレーンテキストのまま、少しだけルールを足して読みやすくする記法”
と理解すれば十分である。
普通のテキストだけだと、見出しやリスト、強調、引用などを分かりやすく表現しにくい。
一方でHTMLのような本格的なタグを書くと、今度は少し重く感じる。
その中間のような存在として、シンプルで書きやすいのがマークダウンである。
なぜマークダウンが使われるのか
マークダウンが広く使われる理由は、書きやすさ と 読みやすさ のバランスがよいからである。
たとえば、文章を整理したいときに
- 見出しを付けたい
- 箇条書きにしたい
- 大事なところを強調したい
- コードを別枠で見せたい
- リンクを分かりやすく入れたい
といったことはよくある。
マークダウンなら、それらを比較的少ない記号で表現できる。
つまりマークダウンは、
「ただのメモ」より整理しやすく、「HTML」より軽く書ける
というちょうどよさがある。
どんなイメージで考えればよいか
初心者向けには、次のようなたとえが分かりやすい。
文章に目印を付けるルール
「ここは見出し」「ここは箇条書き」「ここは強調」と、最小限の目印を付けるイメージ。
整理しやすいメモ帳
ただ書くだけのメモではなく、見出しやリストであとから見返しやすくしたメモ帳に近い。
文章用の軽い記号ルール
難しいプログラムではなく、文章を少し整えるための簡単なルールセットと考えるとわかりやすい。
よく使う基本記法
マークダウンにはいろいろな書き方があるが、初心者がまず覚えやすい代表例は次の通りである。
見出し
# 大見出し
## 中見出し
### 小見出し
箇条書き
- 項目1
- 項目2
- 項目3
番号付きリスト
1. 手順1
2. 手順2
3. 手順3
太字
**ここを強調**
リンク
[サイト名](https://example.com)
コード
`console.log()`
表
| 名前 | 年齢 |
| --- | --- |
| 太郎 | 20 |
| 花子 | 22 |
このように、見た目はシンプルだが、表示すると整理された文章になりやすい。
コードブロックとの相性がよい
マークダウンは、コードを文章の中にきれいに入れたいときにも便利である。
たとえば、複数行のコードをまとめて表示したいときは、コードブロックを使う。
```javascript
function hello() {
console.log("Hello");
}
```
これにより、普通の文章とコードを見分けやすくできる。
そのため、プログラミング学習や技術記事、README との相性が非常によい。
HTMLとの違い
初心者が気になるのが、HTMLとの違いである。
HTML
Webページを作るための本格的なマークアップ言語。
細かい構造や表示を詳しく指定できる。
マークダウン
文章を簡単に整理するための軽量な記法。
HTMLより手軽だが、できることはやや限定される。
つまり、
- HTML = 本格的にWebページを作る
- Markdown = 文章を軽く整える
という違いで考えると分かりやすい。
どんな場面で使われるのか
マークダウンは、今ではかなり幅広い場面で使われている。
1. README
2. メモ・ノート
Obsidian、Notion、各種メモアプリなど。
3. 技術記事や仕様メモ
開発手順、設計メモ、手順書など。
4. AIへの指示文
見出しや箇条書きで整理した方が、AIにも意図が伝わりやすいことが多い。
5. ドキュメント管理
チーム内のルールブック、手順書、ナレッジ共有など。
つまりマークダウンは、
「文章を整理したい場面」全般で使いやすい
のである。
AIとの相性がよい理由
マークダウンがAIと相性がよいと言われるのは、文章構造がはっきりしやすいからである。
たとえば、
- 見出しで話題を分ける
- 箇条書きで条件を整理する
- コードブロックで命令とコードを分ける
- 表で比較項目を並べる
といったことができる。
これによりAIは、
- 何が見出しなのか
- 何が条件なのか
- 何がコードなのか
- 何が補足なのか
を読み取りやすくなることが多い。
そのため、AIへ指示するときも、ただ長文で書くよりマークダウンで整理した方が意図が伝わりやすい場合がある。
GitHubでの重要性
マークダウンは GitHub と特に相性がよい。
たとえば GitHub の README.md は、リポジトリを開いたときに最初に見られる説明書としてよく使われる。
ここに、
- 何のプロジェクトか
- どうやって起動するか
- どんな機能があるか
- スクリーンショット
- 使い方
などを書いておくと、他人にも自分にも分かりやすい。
つまりマークダウンは、
コードの周辺情報を整理して伝えるための定番形式
でもある。
Markdown と JSON の違い
関連用語として JSON と少し混同されやすいが、役割はかなり違う。
Markdown
人間向けの文章を整理しやすくする記法。
JSON
システム間でデータをやり取りしやすくするデータ形式。
つまり、
- Markdown = 文書向け
- JSON = データ向け
という違いである。
マークダウンのメリット
1. 書きやすい
記号が少なく、覚えやすい。
2. 読みやすい
生テキストの状態でも比較的意味が分かりやすい。
3. ツール対応が多い
GitHub、Obsidian、Notion など、多くのツールで使われる。
4. AIと相性がよい
文章構造を整理して伝えやすい。
5. コードや手順書に向いている
見出し、リスト、コードブロックが使いやすい。
マークダウンの注意点
1. 方言がある
元になったのは John Gruber の Markdown（2004年）で、あとの仕様として CommonMark がある。ツールによって、表やチェックリストなど細かい対応が少し違う。たとえば GitHub Flavored Markdown は CommonMark を土台に、チェックリストや表などを加えている。
2. 複雑なデザインには向かない
HTML や CSS のような細かな見た目調整は苦手である。
3. 記号を崩すと表示が変わる
バッククォートやアスタリスクの数が違うと、意図通り表示されないことがある。
4. ネストが深いと見づらくなることがある
箇条書きやコードブロックが重なると少しややこしい。
AIコーディングとの関係
AI時代では、マークダウンは「きれいな文章を書くため」だけでなく、
AIに分かりやすく意図を伝えるための形式
としても価値が高い。
たとえば、
- 要件定義
- 指示書
- ルール集
- 記事構成
- FAQ
- 手順書
などをマークダウンで整えておくと、人間にもAIにも扱いやすくなる。
そのため、開発、ブログ運営、ナレッジ管理、AI活用のどれでも、マークダウンを知っているとかなり便利である。
よくある勘違い
マークダウン = プログラミング言語？
違う。
文章の構造を整理するための記法であり、プログラミング言語そのものではない。
マークダウンを書けばそのままWebアプリになる？
そうではない。
文書としては整えやすいが、アプリの機能を作るものではない。
HTMLが分かればマークダウンは不要？
不要ではない。
軽く素早く文書を整えたい場面では、マークダウンの方が便利なことが多い。
AI向けの特別な形式？
AIと相性はよいが、もともとは人間向けの文書整理記法である。
記号を覚えるのが難しそう？
基本はかなり少ない。
見出し、箇条書き、太字、コードブロックあたりだけでも十分実用になる。
まとめ
- マークダウンは、見出しやリスト、強調などの文章構造を、簡単な記号で書ける軽量な記法のこと。
- HTMLより手軽に書けるが、できることはやや限定される軽量マークアップ言語の一種である。
- README、メモ、技術記事、AIへの指示文など、文章を整理したい場面で幅広く使われる。
- 見出し・箇条書き・太字・コードブロックといった基本記法だけでも十分実用になる。
- 文章構造がはっきりするため、人間だけでなくAIにも意図が伝わりやすい形式である。
情報ソース
より詳しくAIに聞いてみよう
- マークダウンとは何かを、中学生でもわかるように説明してください。
- HTMLとマークダウンの違いを初心者向けに整理してください。
- READMEでよく使うマークダウン記法を一覧で教えてください。
- AIへの指示文をマークダウンで整理すると何がよいのか説明してください。
- コードブロックや表を含む、実用的なマークダウン例を見せてください。