Markdown(マークダウン)とは?
Markdown(マークダウン)は、シンプルな記号だけで見出し・太字・リスト・リンクなどを書ける軽量マークアップ言語です。
この記事では初心者向けに基本文法をすべて網羅し、実際に使えるMarkdown例と「コピペボタン」を用意しました。
Markdown(マークダウン)は何で使える?
Markdownは、プレーンテキストのまま書ける手軽さと、HTMLへの変換のしやすさから、さまざまな場面で活用されています。ここでは主な利用シーンを紹介します。
ドキュメント・README
GitHubやGitLabのREADME.md、技術ドキュメント、仕様書などに広く使われます。コードと一緒に説明を書くのに便利です。
ブログ・静的サイト
Jekyll、Hugo、Astroなどの静的サイトジェネレーター、はてなブログ、Qiita、Zennなどで記事を書くときに使います。
ノート・知識管理
Obsidian、Notion、Logseq、Roam Researchなどのノートアプリで、階層的なメモやリンクを簡単に作れます。
チャット・コミュニティ
Discord、Slack、Reddit、一部のフォーラムで、太字・リスト・コードブロックなどを手軽に入力できます。
プレゼン・スライド
MarpやReveal.jsなどで、Markdownからスライドを生成できます。
電子書籍・PDF変換
Pandocなどを使って、MarkdownからPDF、Word、EPUBなどに変換できます。
メールやその他
一部のメールクライアントやWikiでもサポートされています。
このようにMarkdownは、技術者だけでなくライターや一般ユーザーにも広く使われる便利な記法です。まずは簡単なリストや見出しから試してみてください。
見出し(Headings)
行の先頭に # を付けます。数が増えるほど小さい見出しになります(h1〜h6)。
# 見出し1(最も大きい)
## 見出し2
### 見出し3
#### 見出し4
##### 見出し5
###### 見出し6
強調(太字・斜体・打ち消し線)
アスタリスク(*)やアンダースコア(_)で囲みます。
**太字** または __太字__
*斜体* または _斜体_
***太字かつ斜体***
~~打ち消し線~~
斜体 または 斜体
太字かつ斜体
リスト(箇条書き・番号付き)
箇条書き(順序なし)
- りんご
- バナナ
- 完熟バナナ
- 青バナナ
- みかん
* アスタリスクでもOK
+ プラスでもOK
- りんご
- バナナ
- 完熟バナナ
- 青バナナ
- みかん
番号付きリスト
1. まず準備する
2. 次に実行する
3. 最後に確認する
- まず準備する
- 次に実行する
- 最後に確認する
リンク
[表示テキスト](https://example.com)
[表示テキスト](https://example.com "ツールチップ")
<https://example.com> ← URLをそのままリンクにする
画像
リンクの先頭に ! を付けます。


コード(インライン・ブロック)
インラインコード
変数 `name` に値を代入します。
name に値を代入します。コードブロック
```javascript
function hello(name) {
console.log("Hello, " + name);
}
```
function hello(name) {
console.log("Hello, " + name);
}
引用(Blockquote)
> これは引用文です。
> 複数行も書けます。
>
> > 入れ子の引用も可能です。
これは引用文です。
複数行も書けます。入れ子の引用も可能です。
水平線
---
または *** や ___ でも同じです。
表(テーブル)
GitHub Flavored Markdown(GFM)で利用できます。WordPressの多くのエディタでも対応しています。
| 名前 | 年齢 | 出身地 |
|----------|------|----------|
| 田中 | 28 | 東京 |
| 鈴木 | 34 | 大阪 |
| 佐藤 | 22 | 福岡 |
| 名前 | 年齢 | 出身地 |
|---|---|---|
| 田中 | 28 | 東京 |
| 鈴木 | 34 | 大阪 |
| 佐藤 | 22 | 福岡 |
右寄せ・中央揃えも可能です:
| 左寄せ | 中央揃え | 右寄せ |
|:-------|:--------:|-------:|
| 左 | 中央 | 右 |
タスクリスト(チェックボックス)
- [x] 完了したタスク
- [ ] 未完了のタスク
- [ ] もう一つのタスク
- 完了したタスク
- 未完了のタスク
- もう一つのタスク
エスケープ(記号をそのまま表示)
Markdownの記号を文字として表示したいときは、バックスラッシュ(\)を前に付けます。
\*これは斜体になりません\*
\# これは見出しになりません
# これは見出しになりません
まとめ
Markdownの基本は「記号を少し覚えるだけ」です。
見出し・強調・リスト・リンク・コードさえ覚えれば快適に書けるようになります。
この記事のコード例はすべてコピペ可能です。
ぜひ実際に試してみて、Markdownの書きやすさを体感してください。
