Markdownの書き方入門 | 見出し・リスト・リンクの基本構文

Markdown（マークダウン）は、プレーンテキストで文書を書くための軽量マークアップ言語です。GitHub・Notion・Qiita・Zennなど多くのサービスで採用されており、エンジニアやライターに広く使われています。この記事では基本的な構文をオンラインエディタを使いながら学べます。

Markdownとは？

Markdown は 2004年に John Gruber によって設計された記法で、HTML を直接書かなくても読みやすいプレーンテキストで構造化された文書を作成できます。.md 拡張子のファイルが一般的です。

特徴は「書いたテキストがそのまま読める」こと。# 見出し と書けば見出しになりますが、書いている最中もその意味が直感的にわかります。

基本構文一覧

見出し（Headings）

# 見出し1（h1）

## 見出し2（h2）

### 見出し3（h3）

#### 見出し4（h4）

# の数が多いほど小さい見出しになります。# の後には必ず半角スペースを入れましょう。

テキスト装飾

**太字**　または　__太字__

*斜体*　または　_斜体_

~~打ち消し線~~

`インラインコード`

リンク・画像

[リンクテキスト](https://example.com)

![代替テキスト](画像URL)

コードブロック

```javascript

console.log('Hello, World!');

```

バッククォート3つで囲み、言語名を指定するとシンタックスハイライトが適用されます（対応サービスによる）。

引用（Blockquote）

> これは引用文です。

> 複数行も書けます。

テーブル（表）

| 列1 | 列2 | 列3 |

|-----|-----|-----|

| A | B | C |

| D | E | F |

オンラインMarkdownエディタの使い方

st0z.com の Markdown エディタはリアルタイムプレビュー付きで、書きながら仕上がりを確認できます。

左側のエディタにMarkdown記法でテキストを入力します
右側にリアルタイムでHTML変換されたプレビューが表示されます
「コピー」ボタンでMarkdownまたはHTMLをコピーできます

Markdownが使われる主なサービス

GitHub：README.md、Issues、Pull Request のコメント
Notion：ドキュメント・メモ管理
Qiita / Zenn：技術記事の投稿
Slack / Discord：一部のMarkdown記法が使える
VS Code：Markdownのプレビュー機能が内蔵

よくある質問

Q. HTMLとMarkdownはどう違うの？

A. HTMLは正確に構造を指定できますが記述量が多くなります。Markdownは簡潔に書けますが表現力はHTMLより限られます。MarkdownはHTMLに変換して表示されることが多く、補完関係にあります。

Q. Markdownの方言（フレーバー）とは？

A. 基本的なMarkdownに加え、GitHubやQiitaなどが独自の拡張を加えた「GitHub Flavored Markdown（GFM）」などが存在します。チェックボックス・テーブルなどはGFMで追加された機能です。

まとめ

Markdownは覚えるべき構文が少なく、すぐに使い始められるシンプルな記法です。GitHubやNotionなど多くのサービスに対応しており、エンジニア・ライター問わず知っておくと役立ちます。オンラインエディタで実際に書きながら構文を体で覚えましょう。

▶ 今すぐ試してみる

st0z.com Markdownエディタ（リアルタイムプレビュー付き）

Markdownの書き方入門 — 見出し・リスト・リンクの基本構文