Markdownとは？はじめての人向けに基本記法をやさしく解説

「Markdown」という言葉は目にするけれど、実際に何を指すのか説明できない、という声をよく聞きます。自分自身、最初に触れたときは「なぜ記号だらけの文章を書くのか」まったく分かりませんでした。今ではこのサイトの記事も、ツールの仕様メモも、日々の作業ログも、ほぼすべてMarkdownで書いています。この記事では教科書的な説明だけでなく、実際に手を動かしながら覚えた記法と、初心者が最初につまずきやすい点を、具体的なコード例と一緒にまとめます。

Markdownは「記号だけでできたテキスト」

Markdownの正体は驚くほど単純です。特別なファイル形式ではなく、.txt と同じ「ただのテキストファイル」に、いくつかの記号ルールを乗せただけのものです。見出しには #、箇条書きには -、強調には ** を使う、というように、記号の位置と組み合わせが文章の構造を表します。

専用ソフトがなくても、メモ帳一つで書けて、書いた内容はそのままでも人間が読める。これがMarkdownの一番の強みです。ソフトの見た目の調整に振り回されず、「ここは見出し」「ここは重要」という文章の意味に集中できます。

実際に書いてみる：見出し

見出しは、行の先頭に # を必要な数だけ並べて作ります。

# 大見出し（レベル1）
## 中見出し（レベル2）
### 小見出し（レベル3）

Markdown対応のエディタやブログでこれを表示すると、# が1つなら一番大きな見出し、### なら小さな見出しとして表示されます。数字ではなく記号の数で階層を表す、という発想がポイントです。

最初につまずいたのは、# の直後に半角スペースを入れなかったことでした。#見出し のように記号と文字をくっつけて書くと、多くのエディタでは見出しとして認識されず、#見出し という文字列がそのまま表示されてしまいます。# 見出し のように、# の後ろに半角スペースを1つ入れる——これだけで解決します。

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

箇条書きは -（または *）、番号付きリストは 1. のような数字で書きます。

- 見出しを付ける
- 箇条書きにする
- 強調する

1. まず全体を書く
2. 見出しを付ける
3. 読み返して整える

表示結果は次のようになります。

見出しを付ける
箇条書きにする
強調する

まず全体を書く
見出しを付ける
読み返して整える

多くの人がつまずくのは、リストの前後に空行を入れ忘れることです。直前の段落の文章とリストの行がくっついていると、リストとして認識されずに1行の普通の文章として表示されてしまうエディタがあります。「段落」「リスト」「見出し」はそれぞれの前後を空行で区切る、と覚えておくと事故が減ります。

強調（太字・斜体）

文字を ** で囲むと太字、* または _ で囲むと斜体になります。

これは**太字**です。
これは*斜体*です。
太字と*斜体*を組み合わせることも**できます**。

表示結果はこうなります。

これは太字です。これは斜体です。太字と斜体を組み合わせることもできます。

注意したいのは、囲む記号と文字の間に余計なスペースが入ると強調が効かないことです。たとえば ** 太字** のように記号の直後に半角スペースを入れてしまうと、太字にならず記号がそのまま文字として表示されるエディタが多くあります。囲む記号は文字にぴったり密着させる、というのがコツです。

リンクと引用

リンクは [表示文字](URL)、引用は行の先頭に > を置きます。

[参考リンクの例](https://example.com)

> ここは引用です。他の文章から抜き出した部分だと分かるように表示されます。

表示結果は以下のとおりです。

参考リンクの例

ここは引用です。他の文章から抜き出した部分だと分かるように表示されます。

表（テーブル）

縦棒 | とハイフンの行を組み合わせると、簡単な表が作れます。

| 記法 | 効果 |
| --- | --- |
| `#` | 見出し |
| `-` | 箇条書き |
| `**` | 太字 |

表示結果です。

記法	効果
`#`	見出し
`-`	箇条書き
`**`	太字

Excelのような計算機能はありませんが、情報を整理して見せるだけなら十分な表現力があります。列の幅をきれいに揃えて書かなくても、| の数と位置が合っていれば正しく表になります。

初心者が本当につまずく3つの落とし穴

ここまでの記法さえ覚えれば最低限は書けますが、実際に苦戦したのは記法そのものより「見えない文字」との付き合い方でした。

1. 全角スペースは区切りとして認識されない

日本語入力のまま #　見出し（# の後ろが全角スペース）と書いてしまうケースです。見た目はスペースが入っているように見えても、多くのMarkdownの解釈エンジンは半角スペースしか区切りとして認識しません。結果として見出しが見出しとして表示されず、しばらく原因が分からず悩みました。日本語入力モードのまま記号を打つときは、スペースだけ半角に切り替える癖をつけると事故が減ります。

2. 改行しても行は分かれない

文章の途中で普通に改行しても、多くのMarkdownの実装では1つの段落として詰めて表示されます。見た目上は改行しているのに、表示結果では1行につながってしまうのです。行を本当に分けたい場合は、行末に半角スペースを2つ入れるか、間に空行を1行挟んで別の段落にする必要があります。長文を書いてレイアウトが崩れて見えるときは、まずこの改行の扱いを疑うと解決が早いです。

3. インデントを深くしすぎるとコードブロックになる

リストの中に補足を書き足そうとして、行頭に半角スペースを4つ以上入れると、多くのMarkdownでは「コードブロック」として扱われ、意図と違う見た目（等幅フォントの枠）になってしまいます。階層を深くしたいときはスペース2つ程度に留めるか、記法自体が正しいか確認しながら調整するのが安全です。

変換から入るのも一つの方法

ゼロからMarkdownで書き始めるのが大変な場合、すでに手元にあるWordやExcelの資料をMarkdownに変換してから調整する、という順番もあります。過去に作った資料をMarkdownに直すときは、shiyosho のような変換ツールでいったんベースを作り、そこから見出しや強調を手直しする、という流れで進めることが多いです。ゼロから記法を覚えるより、変換された文章を見比べながら直す方が身につくスピードは早いように感じています。

まとめ

Markdownは、# や - といった数種類の記号だけで文章の構造を表す、シンプルな書き方です。見出し・リスト・強調・リンク・引用・表という基本記法を実際に手で書いてみると、思っているより覚えることは少ないと分かります。一方で、全角スペース・改行の扱い・インデントの深さといった「見えない文字」に関するつまずきは、記法そのものより厄介です。まずは短いメモから、実際にエディタで書いて表示を確かめながら慣れていくのが、結局は一番の近道だと感じています。