Markdownとは？初心者向け完全ガイド
Markdownは、2004年にJohn Gruberが作成した軽量なプレーンテキスト向けの書式です。HTMLのような複雑なマークアップに触れることなく、見出しなら#、太字なら**太字**といった、シンプルで読みやすい記号を使って書式付きドキュメントを作成できます。
今日、Markdownは世界中の何百万もの開発者、ライター、学生、ブロガーに使用されています。GitHub、Reddit、Stack Overflow、Discord、Slackなど、多くのプラットフォームで標準の記法として使われています。
.mdファイルとは？
.mdファイルは、Markdown構文を含むプレーンテキストファイルです。.md拡張子は「Markdown」を表します。.markdownという拡張子も見かけることがありますが、.mdの方がはるかに一般的です。
.mdファイルはプレーンテキストなので、任意のテキストエディタで開けます — メモ帳、TextEdit、VS Code、さらにはWebブラウザでも。書式が表示されるのは、Markdown対応アプリケーションで開いた場合だけです。
なぜMarkdownが作られたのか？
John GruberはMarkdownを、ある一つの目標をもって設計しました：プレーンテキストとして読めること。HTMLやLaTeXとは異なり、Markdownドキュメントはレンダリングしなくても完全に読めます。比較してみましょう：
## HTML版
<h2>私のタイトル</h2>
<p>これは<strong>太字</strong>の単語です。</p>
## Markdown版
## 私のタイトル
これは**太字**の単語です。どちらも同じ出力を生成しますが、Markdown版はソースのままですぐに読めます。
誰がMarkdownを使っているのか？
- 開発者 — READMEファイル、ドキュメント、コードコメント
- テクニカルライター — APIドキュメント、ユーザーガイド、Wiki
- ブロガー — Ghost、WordPress、Jekyllなどのプラットフォームのブログ記事
- 学生 — ノート、論文、プレゼンテーション
- データサイエンティスト — Jupyterノートブック、R Markdownレポート
- プロジェクトマネージャー — GitHub/GitLabイシュー、Confluenceページ
Markdownはどこで使われているのか？
Markdownはどこにでもあります。対応している人気プラットフォームの一部を紹介します：
- GitHub / GitLab — READMEファイル、イシュー、プルリクエスト、Wiki
- Stack Overflow — 質問と回答
- Reddit — コメントフォーマット
- Discord / Slack — メッセージフォーマット
- Notion / Obsidian / Bear — ノートアプリ
- Ghost / Jekyll / Hugo — 静的サイトジェネレーターとブログ
- VS Code / Atom — ドキュメントとプレビュー
基本的なMarkdown構文
最もよく使われるMarkdown要素を紹介します：
見出し
# 見出し1
## 見出し2
### 見出し3太字＆斜体
**太字テキスト**
*斜体テキスト*
***太字と斜体***リスト
- 順序なしアイテム
- 別のアイテム
1. 順序付きアイテム
2. 別のアイテムリンク＆画像
[リンクテキスト](https://example.com)
コード
インライン `コード` はバッククォートで囲みます。
```javascript
// シンタックスハイライト付きコードブロック
console.log("Hello, Markdown!");
```引用＆テーブル
> これは引用です。
| ヘッダー1 | ヘッダー2 |
|----------|----------|
| セル1 | セル2 |完全なリファレンスについては、Markdownチートシートをご覧ください。
Markdownのフレーバー
元のMarkdownには、「フレーバー」と呼ばれるいくつかの拡張バージョンがあります：
- CommonMark — 標準化された明確なMarkdown仕様
- GitHub Flavored Markdown (GFM) — テーブル、タスクリスト、取り消し線、シンタックスハイライトを追加
- Markdown Extra — 脚注、定義リスト、略語を追加
- R Markdown — Rコード実行によるデータサイエンス向け拡張
- MultiMarkdown — テーブル、脚注、メタデータサポートを追加
ほとんどの現代ツールはGFMまたはCommonMarkをサポートしており、日常的なユースケースの95%をカバーしています。
Markdownの書き始め方
- テキストエディタを開く — VS Code、メモ帳、TextEdit、あるいはWebアプリでも
- コンテンツを書く — Markdown構文を使用
- .mdとして保存 — これで有効なMarkdownドキュメントの完成です
- プレビューまたは変換 — Markdownビューアーで出力を確認するか、PDF/HTML/Wordに変換
Markdownを他のフォーマットに変換
Markdownの最大の強みの一つは、他のフォーマットへの変換が簡単なことです。一つのMarkdownファイルを以下に変換できます：
- PDF — 共有、印刷、アーカイブ用
- Word (.docx) — コラボレーションと編集用
- HTML — Web公開用
- LaTeX — 学術論文用
- 画像 (PNG/JPEG) — SNS共有用
よくある質問
MarkdownとHTMLは同じですか？
いいえ。MarkdownはHTMLよりはるかにシンプルです。Markdownは**太字**を使いますが、HTMLは<strong>太字</strong>を使います。Markdownは読みやすさのために設計されており、HTMLはWeb構造のために設計されています。必要に応じてMarkdown内にHTMLを埋め込むことができます。
プロフェッショナルなドキュメントにMarkdownを使えますか？
はい。Markdownはプロフェッショナルなドキュメント、テクニカルライティング、出版に広く使用されています。多くの企業（GitHub、Stripe、Twilio）が公式ドキュメントにMarkdownを使用しています。MarkdownをPDFやWordに変換すれば、完成度の高い最終ドキュメントを作成できます。
Markdownは無料ですか？
Markdownは完全に無料でオープンソースです。構文は無料で使用でき、何百もの無料エディタやツールが利用可能です。
.mdと.txtの違いは何ですか？
どちらもプレーンテキストファイルです。違いは、.mdファイルがMarkdownの書式を使用することです。.txtファイルには書式がありません。.mdファイルをMarkdown対応エディタで開くと書式付きのテキストが表示され、プレーンテキストエディタでは生の構文が表示されます。