# Markdownとは？

> Markdownとは、プレーンテキストに見出し・リスト・リンク・表などの構造を足すための軽量な書き方です。.mdファイルの意味、基本例、AIに向いている理由を解説します。

## まず答え

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

```markdown
# 会議メモ

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

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

## .mdファイルとは

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

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

## よく使う記法

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

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

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

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

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

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

## AIに向いている理由

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

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

悪い入力:

```text
Q3 売上 地域 北 1240 南 920 東 1510
```

良い入力:

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

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

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

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

## いつ使うと便利か

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

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

:::tip
はじめてなら、まず [Markdownチートシート](/ja/cheat-sheet/) を開いて、よく使う記法だけコピーして試してください。
:::

## 次に読む

- [AIのためのMarkdown](/ja/markdown-for-ai/) — AIに読ませる文書でMarkdownが効く理由。
- [Markdownの表](/ja/tables/) — AIが読み間違えやすい表の整え方。
- [VS CodeでMarkdownをプレビュー](/ja/vscode-preview/) — 書いたMarkdownの見え方を確認する方法。