Markdownは、プレーンテキストの文字を使ってテキストをフォーマットするシンプルな方法です。GitHub、Reddit、Notion、Discord、技術ドキュメントなど、あらゆるところで使われています。太字にしたり見出しを作ったりするためにボタンをクリックする代わりに、シンプルな記号を入力するだけです。このチュートリアルでは基本を教え、無料のMarkdownプレビューツールで練習できるようにします。
必要なもの
- Webブラウザ（Chrome、Firefox、Safari、またはEdge）
- アカウント登録やインストールは不要
- 基本を学ぶのに約10分
ステップバイステップガイド
Markdownプレビューツールを開く
Markdownプレビューツールを開きます。分割画面エディタが表示されます：左側にMarkdownを書き、右側にリアルタイムでフォーマットされたプレビューが表示されます。入力するたびに即座にプレビューに反映されます。
基本構文を学ぶ
エディタに入力してMarkdownフォーマットを試してみましょう。基本構文はシンプルで数分で学べます。下の例を使って練習しましょう — 左側に入力すると、右側にフォーマットされた結果が表示されます。
ドキュメントを書く
実際のコンテンツを書きましょう。見出しでドキュメントを構造化し、リストで情報を整理し、太字や斜体で強調します。リアルタイムプレビューにより、入力しながら最終結果がどうなるか常に確認できます。
結果をエクスポートまたはコピーする
ドキュメントが望み通りになったら、Markdownテキストをコピーして対応プラットフォームで使用するか、フォーマットされた結果をエクスポートします。MarkdownコンテンツはGitHub、Reddit、Notion、その他のMarkdown対応エディタにペーストできます。
豆知識 Markdownはレンダリングしなくても読めるように設計されています。Markdownドキュメントはプレーンテキストとしても整然として構造化されて見えます。これがMarkdownが広く普及した理由の1つです。
基本的なMarkdown構文
見出し
#記号を使って見出しを作成します。#が多いほど小さな見出しになります：
# 見出し1（最大）
## 見出し2
### 見出し3
#### 見出し4
太字と斜体
アスタリスクでテキストを囲んで強調します：
**これは太字テキストです**
*これは斜体テキストです*
***これは太字かつ斜体です***
リスト
ダッシュで箇条書きリスト、数字で番号付きリストを作成します：
- 最初の項目
- 2番目の項目
- 3番目の項目
1. ステップ1
2. ステップ2
3. ステップ3
リンク
角括弧と丸括弧でクリック可能なリンクを作成します：
[リンクテキスト](https://example.com)
コード
インラインコードにはバッククォート、コードブロックにはトリプルバッククォートを使用します：
インライン: `console.log("hello")`
コードブロック:
```javascript
function greet(name) {
return "Hello, " + name;
}
```
ヒント すべてを一度に覚える必要はありません。見出し、太字、リストの3つから始めましょう — これだけで一般的なMarkdown記述の80%をカバーできます。必要に応じて構文を追加していきましょう。
画像
リンク構文の前にエクスクラメーションマークを付けて画像を追加します：
引用
>を使って引用テキストを作成します：
> これは引用です。
> 複数行にまたがることもできます。
Markdownが使われている場所
| プラットフォーム | Markdownの使われ方 |
|---|---|
| GitHub | READMEファイル、Issue、プルリクエスト、コメント |
| 投稿とコメントのフォーマット | |
| Notion | ページコンテンツとドキュメント |
| Discord | メッセージのフォーマット |
| Stack Overflow | 質問、回答、コメント |
| 静的サイトジェネレーター | ブログ記事とページコンテンツ |
重要 プラットフォームによってサポートするMarkdown機能がわずかに異なります。基本（見出し、太字、斜体、リスト、リンク）はどこでも使えます。表や脚注などの高度な機能はプラットフォームによって異なります。新しいプラットフォームで公開する前に必ずプレビューしてください。
よくある質問
MarkdownとHTMLの違いは何ですか？ Markdownは裏側でHTMLに変換されます。HTMLタグを覚えなくてもフォーマットされたテキストを書けるシンプルな方法です。Markdownを受け付ける場所では、HTMLとしてレンダリングされます。
Markdownで業務用ドキュメントを作成できますか？ もちろんです。多くのチームがドキュメント、提案書、レポートにMarkdownを使用しています。MarkdownをPDF、Word、プレゼンテーション形式に変換するツールも存在します。
構文はどこでも同じですか？ 基本構文は共通です。一部のプラットフォームは拡張機能を追加しています（GitHub Flavored Markdownは表やタスクリストを追加しています）。このチュートリアルでカバーした基本はどこでも使えます。
次のステップ
Markdownを覚えたら、プロジェクトのREADMEを書いたり、ブログ記事をフォーマットしたり、技術ドキュメントを作成してみましょう。より高度なフォーマットタスクには、コードドキュメント用のJSONフォーマッターや最終的なドキュメント出力用のPDFエディタもご覧ください。