Markdown文法ガイド|初心者向けに表・リンク・画像・コードの書き方をまとめて解説
Markdown(マークダウン)は、見出し・箇条書き・リンク・表などを、シンプルな記号だけで書ける記法です。ブログの下書き、メモ、技術文書、README、ChatGPTの出力整理など、さまざまな場面で使われています。
ただ、初心者のうちは「どの記法から覚えればいいの?」「表や画像はどう書くの?」「環境によって何が違うの?」と迷いやすいものです。
この記事では、Markdownの基本文法を1ページでざっくり理解できるように整理しつつ、表・リンク・画像・コードブロック・注釈・インデントなど、よく使うテーマごとに詳しい記事へ進めるようにまとめました。
- Markdownの基本文法をまとめて把握したい
- まず何から覚えればいいか知りたい
- 表・リンク・画像・コードの個別記事へ進みたい
- 記事の最後にチートシートも見たい
結論:まずはこの6つを覚えればMarkdownはかなり使えます
最初から全部覚える必要はありません。まずは次の6つを使えるようになるだけで、Markdownの基本はかなり十分です。
- 見出し
- 箇条書き・番号付きリスト
- リンク
- 画像
- 表
- コードブロック
この6つが使えると、メモ・ブログ下書き・簡単な資料・技術メモの多くに対応できます。注釈やインデント調整は、その次の段階で覚えれば十分です。
個別の書き方を詳しく見たい方は、表の書き方、リンクの使い方、画像の入れ方、コードブロックの解説もあわせてどうぞ。
Markdownの基本文法をざっくり確認
| やりたいこと | 書き方の例 | ポイント |
|---|---|---|
| 見出し | # 見出し | # の数で階層を分けます |
| 箇条書き | - 項目 | ハイフンの後に半角スペースを入れます |
| 番号付きリスト | 1. 項目 | 手順や順序のある説明に向いています |
| リンク | [テキスト](URL) | 外部リンクも内部リンクも同じ形です |
| 画像 |  | 先頭に ! が付きます |
| 表 | | 列1 | 列2 | | 比較表や一覧表に便利です |
| コードブロック | ``` で囲む | コードや記法例を見せるときに使います |
まず覚えておきたい基本記法
見出し
見出しは、文章の構造を分かりやすくするための基本です。長い文書ほど、見出しをきちんと付けるだけで読みやすさが大きく変わります。
# 見出し1 ## 見出し2 ### 見出し3
箇条書き・番号付きリスト
要点を整理したいときは、箇条書きや番号付きリストが便利です。特にMarkdownでは、箇条書きを使うだけでも文書の見通しがかなり良くなります。
- 項目A - 項目B - 項目C 1. 手順1 2. 手順2 3. 手順3
強調(太字・斜体)
重要な語句だけを目立たせたいときは、太字や斜体を使います。使いすぎると読みにくくなるので、本当に強調したい部分だけに絞るのがコツです。
**太字** *斜体*
詳しく知りたい人向け:テーマ別の解説記事
ここから先は、よく使うテーマごとに個別記事へ進めるようにしています。まずは気になる項目から読んでください。
表の書き方
Markdownの表は、比較表や一覧表を作るときに便利です。最初は少し記号が多く見えますが、基本形を覚えればすぐに使えるようになります。
表が崩れる原因や整え方まで知りたい方は、Markdownの表の詳しい解説をご覧ください。
リンクの書き方
外部サイトへのリンクや、サイト内の別ページへのリンクをきれいに貼りたいときに使います。内部リンクの整理にも役立ちます。
相対リンクやアンカーリンクまで含めて確認したい方は、Markdownリンクの詳しい使い方も参考になります。
画像の入れ方
画像は、記事やノートを分かりやすくするためによく使います。基本構文だけでなく、表示されない原因や相対パスも押さえておくと便利です。
画像が表示されない原因や相対パスの考え方を詳しく知りたい方は、Markdownで画像を挿入する方法をご覧ください。
コードブロックの書き方
コード例やコピペ用の記法を見せるときに便利なのがコードブロックです。ブログ・技術記事・ChatGPTの出力整理でもよく使います。
バッククォートの使い分けや言語指定まで詳しく知りたい方は、Markdownのコードブロック解説も参考になります。
注釈・脚注
補足説明を本文から少し切り分けたいときに便利なのが注釈・脚注です。ただし、Markdownの環境によって使える場合と使えない場合があります。
表・改行・インデントなどの崩れ方をまとめて確認したい方は、「Markdownが崩れる原因と対策」記事もあわせて読むと理解しやすくなります。
インデントの使い方
インデントは、ネストした箇条書きやコードの読みやすさに関わる大事な要素です。Markdownが崩れる原因にもなりやすいので、別記事で確認しておくと安心です。
初心者はどの順番で覚えるとラク?
- 見出し
- 箇条書き
- リンク
- 画像
- 表
- コードブロック
- インデント
- 注釈・脚注
この順番なら、まず文章の骨組みを作れるようになり、そのあとに表現の幅を広げていけます。最初から応用記法を全部覚えようとしなくて大丈夫です。
Markdownがうまく表示されないときの原因
Markdownはシンプルですが、環境によって微妙に挙動が違います。次のようなポイントでつまずきやすいです。
- 半角スペースが足りない
- インデントの深さがずれている
- 表の区切り線が不足している
- 脚注やチェックボックスが対応していない環境で使われている
- HTML混在で崩れている
「同じ書き方なのに表示が違う」と感じたら、Markdown自体が間違っているというより、使っている環境の違いを疑うと解決しやすいです。
記法チートシート
| 用途 | 記法 |
|---|---|
| 見出し | # 見出し |
| 箇条書き | - 項目 |
| 番号付きリスト | 1. 項目 |
| 太字 | **太字** |
| 斜体 | *斜体* |
| リンク | [テキスト](URL) |
| 画像 |  |
| 引用 | > 引用文 |
| コードブロック | ```コード``` |
| インラインコード | `code` |
| 表 | | 列1 | 列2 | |
文法を一通りつかんだら、次は Markdownエディタ比較 や スマホ向けMarkdownエディタ比較 を読むと、実際の使い方までつなげやすくなります。
まとめ
Markdownは、覚える記法が多そうに見えても、最初に必要なのはそれほど多くありません。まずは見出し・箇条書き・リンク・画像・表・コードブロックの6つを押さえれば、かなり実用的に使えます。
このページでは全体像をざっくりつかみ、気になるテーマは個別記事で深掘りしていくのがおすすめです。まずは必要なところから少しずつ使い始めてみてください。