Markdownはどこで使えますか？

GitHubやNotion、Slackの一部、多くのブログサービスやドキュメントツールで使えます。ただし対応している記法はサービスごとに違い、表やチェックリストなどの拡張記法は使えない場合があります。

改行したのに反映されません。

多くのMarkdownでは、単純な改行は同じ段落の続きとして扱われます。段落を分けたいときは空行を1行入れてください。同じ段落の中で改行したい場合は、行末に半角スペースを2つ置く書き方が使えることがあります。

書いた見た目を確認しながら編集できますか？

プレビュー機能のあるエディタやツールを使うと、記法と表示を並べて確認できます。とくに表やリストの入れ子は、書いただけでは崩れに気づきにくいため、確認しながら書くと手戻りが減ります。

Markdownの書き方ガイド | 見出し・リスト・コード・テーブルを一覧で

GitHub・Qiita・note・Slackなど、いまや日常で使うMarkdownの基本記法を1ページで網羅。よく忘れがちなリンク・画像・テーブルの構文、GitHub拡張記法までまとめます。

Markdown（マークダウン）は、テキストに少し記号を加えるだけで、見出し・リスト・リンク・コードブロックなどを表現できる軽量な記法です。GitHub、Qiita、Zenn、note、Slack、Discord、Notion など、エンジニアでなくても日常的に使う場面が増えてきました。

覚える記号は多くありません。1ページの早見表があれば、ほとんど困らないはずです。ここでは、基本の記法から GitHub Flavored Markdown の拡張記法まで、用途ごとにまとめました。

Markdownとは：読みやすいまま装飾できる記法

Markdownは2004年に John Gruber 氏によって考案された記法で、当時HTMLが必須だったWebの世界に「もっと書きやすく、生のテキストでも読めるフォーマット」を持ち込みました。

例えば **強調** と書けば強調になり、# 見出し と書けば見出しになる。装飾用の記号がそのまま「文章の意味」を表しているので、生のテキストファイルとして読んでも内容が伝わるのが大きな特徴です。

書いた文章は専用のソフト（Markdownプロセッサ）でHTMLや別形式に変換されます。本サイトの Markdownプレビューツールを使えば、書きながら結果を確認できます。

見出し

行の先頭に # を1〜6個並べることで、h1〜h6の見出しを表現できます。# と文字の間には半角スペースを入れます。

# 大見出し — h1（記事タイトルに使う）
## 中見出し — h2（章の見出し）
### 小見出し — h3（節の見出し）
#### 〜 ###### — h4〜h6（細かい階層に使うが、深くしすぎないのがコツ）

実用上は h1〜h3 までで十分です。記事1本に対して h1 は1つ、h2 が章立て、h3 が章の中の節、という構造を意識すると読みやすくなります。

強調・斜体・打ち消し

**強調** または __強調__ → 強調
*斜体* または _斜体_ → 斜体
***強調と斜体*** → 強調と斜体
~~打ち消し線~~ → ~~打ち消し線~~

日本語の場合、文字の前後にスペースを入れずに記号を使うと、サービスによっては装飾が反映されないことがあります（特に古いMarkdownプロセッサ）。困ったときは **こちら** のように前後にスペースを入れると確実です。

リンクと画像

リンク

[表示テキスト](URL) の形で書きます。

例：[TegaruTools](https://tegarutools.com/)
結果：TegaruTools

タイトル属性を付ける場合は [テキスト](URL "ホバー時のタイトル") のように書きます。

画像

![代替テキスト](画像URL) でリンクと同じ書式の頭にビックリマーク。

例：![ロゴ](https://example.com/logo.png)

代替テキスト（alt）は、画像が表示できなかった時に代わりに表示される文字列です。アクセシビリティの観点からも、可能なら入力する習慣を付けてください。

コード

インラインコード

文中にコードを埋め込むときは、バッククォート ` で囲みます。

例：関数 `map` は配列の各要素を変換します。

コードブロック

複数行のコードは、行頭に半角バッククォートを3つ並べて囲みます。

```js のように言語名を入れると、対応サービスでシンタックスハイライトされます。GitHub・Qiita・Zenn・Slack いずれも対応しています。

引用

行頭に > を置くと、引用ブロックになります。

これは引用です。複数行の場合は、各行の先頭に > を置きます。

書籍・記事の引用、または「補足説明」「注意書き」など、本文と区別したい内容を入れる時に便利です。

テーブル（表）

テーブルは縦線 | で列を区切り、見出しと本文の間にハイフン --- の行を入れます。

例：

| ヘッダ1 | ヘッダ2 |
| --- | --- |
| セル | セル |

列の整列は --- 部分で指定します。

:--- — 左寄せ（デフォルト）
:---: — 中央寄せ
---: — 右寄せ

水平線

段落の区切りに水平線を入れたい時は、3つ以上の -、*、_ を単独行に書きます。

---
***
___

GitHub Flavored Markdown (GFM) の拡張記法

GitHub が独自に追加した拡張記法で、現在はQiita・Zenn・GitLab・Slack・Discord などでも広く採用されています。

チェックボックス

- [ ] 未完了タスク
- [x] 完了タスク

TODOリストや、PullRequestのレビュー項目で重宝します。

シンタックスハイライト

コードブロックに言語名を指定すると、その言語に合わせた色付けがされます。例：```python、```javascript、```sql、```yaml など。

絵文字ショートコード

:smile:、:rocket:、:warning: といった書き方で絵文字を入れられます。GitHub・Slack で動作。

URL の自動リンク化

https://example.com/ のように生のURLを書くだけで、自動的にリンクとして処理されます。

取り消し線

~~取り消し~~ で ~~取り消し~~ になります（前述）。

Markdownが使える主なサービス

GitHub：README、Issue、PullRequest、Wiki、Discussions すべてMarkdown。
Qiita / Zenn / note：日本の技術ブログ・記事サービス。
Notion：エディタ内で ** や # を入力するとMarkdown風に変換される。
Slack / Discord：メッセージで *強調*、`コード`、```ブロック``` が使える。
VS Code、Typora、Obsidian：Markdownエディタとして人気。リアルタイムプレビュー付き。

書きやすくなるコツ

プレビューを見ながら書く：本サイトの Markdownプレビューツールはブラウザ完結で、書きながら結果を確認できます。
段落の間は空行を入れる：改行だけだと「
」になるので、段落として区切りたい時は1行空ける。
記号の前後に半角スペース：日本語環境では、Markdownの記号と日本語が密着していると認識されないことがある。
長すぎる行は折り返す：1行が長くなりすぎると編集時に見にくい。70〜80文字で改行する習慣が読みやすい。
HTML も使える：表現できない装飾はHTMLで書ける（ほとんどのMarkdownプロセッサが対応）。ただし依存しすぎると可搬性が落ちる。

まとめ：1日で身につく、一生使える記法

Markdownは覚える記号が少なく、それぞれの意味も直感的です。集中して取り組めば、1〜2時間あれば十分に書けるようになります。

一度身につけてしまえば、技術記事やREADME、SlackやDiscordでの整理された投稿、Notionの議事録、ブログ執筆まで、いろいろなテキスト作業で時間を節約できます。書式ボタンを押す手間から解放され、書くことそのものに集中できるようになります。