Markdown完全ガイド - 基礎から応用まで
📷 Markus Winkler / PexelsMarkdown完全ガイド - 基礎から応用まで
このガイドでMarkdownをマスターしましょう。基本的な書式設定から、テーブル、タスクリスト、脚注、GitHub Flavored Markdownまで、全構文を網羅しています。例とベストプラクティスも掲載。
はじめに：Markdownとは何か？
Markdownは2004年にJohn Gruberが作成した軽量マークアップ言語です。主な目標は、生の状態でも可能な限り読みやすくしながら、構造的に有効なHTMLに変換できることです。今日、Markdownはドキュメント、READMEファイルからブログ記事、コメント、メッセージングプラットフォームまで、Web上でのコンテンツ作成のデファクトスタンダードになっています。
このガイドを読みながら練習したい方は、MarkdownプレビューツールでリアルタイムにMarkdownのレンダリングを確認できます。
なぜMarkdownを使うのか？
- 読みやすさ：生のMarkdownはレンダリングしなくても読みやすい
- ポータビリティ：プレーンテキストファイルでどこでも動作する
- シンプルさ：構文が直感的で学習が容易
- 広いサポート：GitHub、GitLab、Reddit、Stack Overflow、Notion、Obsidianなどで使用されている
- バージョン管理との相性：プレーンテキストのため、Gitと完全に互換性がある
- 変換可能：HTML、PDF、DOCXなど多様なフォーマットに変換可能
- コンテンツに集中できる：書式ではなく内容に集中できる
基本構文
見出し
見出しは見出しテキストの前に1〜6個の#記号を追加して作成します。
# 見出し1 (H1)
## 見出し2 (H2)
### 見出し3 (H3)
#### 見出し4 (H4)
##### 見出し5 (H5)
###### 見出し6 (H6)
見出しのベストプラクティス：
#と見出しテキストの間には必ずスペースを入れる- ドキュメントにH1は1つだけ使用する（通常はタイトル）
- 見出しレベルをスキップしない（H2からH3へ、H2からH4へは避ける）
- 見出しは簡潔で説明的に保つ
強調（太字・斜体）
*斜体テキスト* または _斜体テキスト_
**太字テキスト** または __太字テキスト__
***太字かつ斜体*** または ___太字かつ斜体___
~~取り消し線~~
引用
> これは引用文です。
>
> 複数の段落にわたることができます。
> 引用はネストできます。
>
>> これはネストされた引用です。
リスト
番号なしリストは-、*、または+を使用：
- 項目1
- 項目2
- ネストされた項目2.1
- ネストされた項目2.2
- 項目3
番号付きリストは数字とピリオドを使用：
1. 最初の項目
2. 2番目の項目
3. 3番目の項目
リンクと画像
リンク
[リンクテキスト](https://example.com)
[タイトル付きリンク](https://example.com "リンクタイトル")
<https://example.com>（自動リンク）
画像
コード
インラインコード
バックティック1つでインラインコードをラップ：
`console.log()`関数を使ってデバッグします。
コードブロック
オプションで言語識別子を付けてトリプルバックティックを使用：
```javascript
function greet(name) {
return `Hello, ${name}!`;
}
```
```python
def greet(name):
return f"Hello, {name}!"
```
テーブル
テーブルはパイプ（|）とハイフン（-）を使用して作成：
| 機能 | フリープラン | プロプラン |
|------|------------|----------|
| ユーザー | 1 | 10 |
| ストレージ | 1 GB | 100 GB |
| サポート | コミュニティ | メール |
レンダリング結果：
| 機能 | フリープラン | プロプラン |
|---|---|---|
| ユーザー | 1 | 10 |
| ストレージ | 1 GB | 100 GB |
| サポート | コミュニティ | メール |
GitHub Flavored Markdown (GFM)
タスクリスト
- [x] プロジェクトセットアップ完了
- [x] ドキュメント作成
- [ ] ユニットテストの追加
- [ ] 本番環境へのデプロイ
レンダリング結果：
- プロジェクトセットアップ完了
- ドキュメント作成
- ユニットテストの追加
- 本番環境へのデプロイ
絵文字
GFMは絵文字ショートコードをサポート：
:smile: :rocket: :bug: :white_check_mark: :warning:
脚注
この主張には出典が必要です[^1]。
[^1]: 出典：コンピュータサイエンスジャーナル、2026年。
Markdownのベストプラクティス
ドキュメント構造
- H1は1つだけ：これは通常ドキュメントのタイトル
- 見出しを階層的に使用：メインセクションにH2、サブセクションにH3
- 段落は短く保つ：1段落あたり3〜5文を目指す
- コードは常に言語を指定：シンタックスハイライトのために言語識別子を付ける
一般的な使用例
READMEファイル
# プロジェクト名
プロジェクトの簡単な説明。
## インストール
\`\`\`bash
npm install project-name
\`\`\`
## 使い方
\`\`\`javascript
import { tool } from 'project-name';
tool.execute();
\`\`\`
Markdownクイックリファレンス
| 要素 | 構文 | 備考 |
|---|---|---|
| 見出し | # H1 〜 ###### H6 | #の後にスペース |
| 太字 | **テキスト** | __テキスト__でも可 |
| 斜体 | *テキスト* | _テキスト_でも可 |
| 取り消し線 | ~~テキスト~~ | GFM機能 |
| 引用 | > テキスト | ネスト可能 |
| 番号付きリスト | 1. 項目 | 番号は自動連番 |
| 番号なしリスト | - 項目 | *または+でも可 |
| インラインコード | `コード` | バックティック1つ |
| コードブロック | ``` | トリプルバックティック |
| リンク | [テキスト](url) | タイトルオプション |
| 画像 |  | タイトルオプション |
| 水平線 | --- | ***または___でも可 |
| テーブル | | 列 | 列 | | GFM機能 |
| タスクリスト | - [x] 完了 | GFM機能 |
| 脚注 | テキスト[^1] | 全員がサポートするわけではない |
まとめ
Markdownは、すべての開発者と技術ライターが習得すべき強力かつシンプルなツールです。プレーンテキスト形式はバージョン管理されたドキュメント、ブログ記事、READMEファイルなどに最適です。
Markdownを練習してリアルタイムでレンダリングを確認するには、Markdownプレビューツールをお試しください。
関連リソース
- Markdownプレビューツール — リアルタイムでMarkdownをプレビュー
- ワードカウンター — Markdownドキュメントの文字数をカウント
- JSONフォーマッター — コードサンプルのJSONをフォーマット
- 初心者向けRegexガイド — テキスト処理のためのRegexを学ぶ