Markdown記法入門｜見出し・リスト・リンク・表の書き方をやさしく解説

ブログ記事、技術ドキュメント、GitHubのREADMEなど、いまや多くの文章が「Markdown」で書かれています。HTMLのように複雑なタグを覚えなくても、記号をいくつか使うだけで見出しやリスト、リンクを表現できるのが魅力です。本記事では、Markdownをはじめて学ぶ方に向けて、その正体と基本的な書き方、実際の活用法までをやさしく解説します。

Markdownとは何か

Markdown（マークダウン）は、プレーンテキストに簡単な記号を加えるだけで、構造を持った文書を書くための軽量マークアップ言語です。2004年にジョン・グルーバー氏らによって考案され、「読み書きしやすいこと」を最優先に設計されています。

Markdownが広く使われる理由は次の3点です。

• 書きながら読める：記号が最小限なので、変換前のテキストのままでも内容が把握できます。
• 環境を選ばない：ただのテキストファイルなので、どんなエディタでも編集でき、バージョン管理とも相性が良いです。
• HTMLへ変換できる：書いたMarkdownはそのままWebページのHTMLに変換でき、ブログやドキュメントサイトで表示できます。

たとえば、次のように書くと「大きな見出し」と「箇条書き」が表現できます。

# タイトル
- 項目A
- 項目B

このように、記号の意味さえ覚えれば、特別なソフトがなくてもメモ帳ひとつで整った文書が書けます。なお、Markdownには方言（流派）があり、表やチェックボックスに対応したGitHub Flavored Markdown（GFM）が現在は事実上の標準になっています。

基本記法：見出し・段落・強調

まずは文章の骨組みになる、見出し・段落・強調の3つを押さえましょう。

見出し

行の先頭に # を置くと見出しになります。# の数が見出しのレベル（大きさ）を表し、1個から6個まで使えます。# のあとには必ず半角スペースを入れます。

# 大見出し（h1）
## 中見出し（h2）
### 小見出し（h3）

段落と改行

文章は空行で区切ると別の段落になります。なお、ただ改行しただけでは段落内の改行として扱われないことが多く、行末に半角スペースを2つ置くか、空行を入れて段落を分けるのが基本です。

強調（太字・斜体）

文字を * や _ で囲むと強調になります。1個で囲むと斜体、2個で囲むと太字です。

**太字になります**
*斜体になります*
~~取り消し線~~（GFM）

太字は重要語の強調に、斜体は補足やニュアンスに使うと読みやすくなります。実際に書いて表示を確かめながら覚えるのがおすすめで、Markdownエディタを使えば、左に書いた記法が右側でどう表示されるかをその場でプレビューできます。

リストとリンク・画像

Markdownが特に得意とするのが、リストとリンクです。

箇条書きと番号付きリスト

行頭に -（またはアスタリスク）を置くと箇条書き、1. のように数字とピリオドを置くと番号付きリストになります。行頭を半角スペースで字下げすると、入れ子（ネスト）も表現できます。

- 果物
  - りんご
  - みかん
1. 手順その1
2. 手順その2

リンクと画像

リンクは [表示テキスト](URL) の形で書きます。画像はその先頭に ! を付けて  と書きます。

[WAZA TOOLS](https://waza.tools)

角かっこに「表示する文字」、丸かっこに「リンク先や画像の場所」を書く、と覚えると混乱しません。画像の代替テキストは、読み上げ環境や画像が表示できないときに役立つので、簡潔に内容を書いておきましょう。

コードと引用・水平線

技術文書では、コードや引用を見やすく示す記法が活躍します。

コード

文中の短いコードは `（バッククォート）で囲みます。複数行のコードはバッククォート3個で上下を囲む「コードブロック」を使い、開始の3個のあとに言語名を書くと色分け表示にも対応できます。

文中の `code` はこう書きます。

引用

行頭に > を置くと引用ブロックになります。出典の紹介や注意書きを目立たせたいときに便利です。

水平線

ハイフンやアスタリスクを3つ以上だけの行にすると、区切りの水平線が引けます（例：---）。話題が大きく変わるところで使うと読みやすくなります。

表（テーブル）の書き方

表はGitHub Flavored Markdown（GFM）の機能で、縦棒 | とハイフンを使って作ります。1行目が見出し、2行目が区切り線、3行目以降がデータです。

| 項目 | 価格 |
| --- | --- |
| りんご | 100円 |
| みかん | 80円 |

2行目の区切り線でコロンの位置を変えると、列ごとの文字寄せ（左・中央・右）も指定できます。:--- で左寄せ、:---: で中央寄せ、---: で右寄せです。

縦棒の位置を手で揃えるのは手間がかかります。列や行が増えるほど崩れやすくなるため、表だけは専用ツールで生成すると確実です。記事が長くなってきたら、見出しから自動で目次を作るMarkdown目次生成ツールも合わせて使うと、読み手が全体像をつかみやすい文書になります。

HTML・PDFへの出力と活用

Markdownの真価は、書いたあとに別の形式へ変換できる点にあります。用途に応じて出力先を選びましょう。

HTMLへの変換とWeb公開

MarkdownはHTMLへ変換するのが最も基本的な使い方です。多くのブログサービスや静的サイトジェネレーターはMarkdownをそのまま受け付け、自動でHTMLに変換して公開してくれます。Markdownエディタでプレビューを確認しながら書けば、公開後の見た目を想像しやすくなります。

PDFへの出力

提案書や手順書を配布したいときは、PDFにすると環境を問わず同じ見た目で渡せます。Markdown→PDF変換ツールを使えば、書いたMarkdownをそのまま体裁の整ったPDFに変換でき、印刷や添付ファイルとしての共有に便利です。

GitHubやドキュメントでの活用

GitHubのREADMEやIssue、Wikiは標準でMarkdownに対応しています。プロジェクトの説明、チェックリスト、コード例などをMarkdownで書けば、見やすく構造化された文書になります。チャットツールやノートアプリでもMarkdownを採用するものが増えており、一度覚えれば多くの場面で再利用できる汎用スキルです。

つまずきやすい点とコツ

最後に、初心者がつまずきやすいポイントと、上達のコツをまとめます。

1. 記号のあとのスペースを忘れない：# や - の直後には半角スペースが必要です。抜けると見出しやリストになりません。
2. 改行は空行で：段落を分けたいときは1行空けます。単純な改行では反映されないことが多いです。
3. 表はGFM対応の環境で：表やチェックボックスは方言（GFM）の機能なので、対応していない環境ではそのまま記号が表示されます。
4. HTMLも混在できる：多くのMarkdownはHTMLタグを直接書くこともできますが、まずは標準記法で十分です。
5. プレビューで確認する習慣を：書いた記法が意図通り表示されるか、エディタのプレビューでこまめに確かめると上達が早まります。

Markdownは覚える記号が少ないわりに、ブログ・技術文書・GitHubと活躍の場が非常に広い記法です。見出し・リスト・リンク・強調・コード・表という基本を押さえれば、すぐに整った文書が書けるようになります。まずはMarkdownエディタに文章を打ち込み、記号を足しながら表示の変化を楽しむところから始めてみてください。