用語集 › 🛠️ 開発ツール › Markdown
【まーくだうん】

Markdown とは？

最終更新:
💡 「書きやすく読みやすい」テキスト書式
📌 このページのポイント
Markdown主要記法の一覧 記法 用途 # / ## / ### 見出し（H1〜H6） **太字** / *斜体* テキストの強調 - 項目 / 1. 項目 箇条書き / 番号付きリスト [テキスト](URL) ハイパーリンク ![代替文](画像URL) 画像の埋め込み `コード` / ```ブロック``` インライン / ブロックコード > 引用文 引用ブロック --- 水平線（区切り） プレーンテキストで書けて、HTMLに変換できる軽量マークアップ言語
Markdown記法のイメージ
ひよこ ひよこ
なぜエンジニアはMarkdownをよく使うの？
ペンギン先生 ペンギン先生
①テキストエディタだけで書ける（Wordなど不要）、②Gitで差分管理できる（バイナリファイルと違って変更箇所が一目瞭然）、③GitHubが標準対応（README.mdがリポジトリのトップに表示される）、④変換ツールが豊富（HTML、PDF、スライドに変換可能）。エンジニアのドキュメント文化のデファクトスタンダードだよ
ひよこ ひよこ
基本的な書き方は？
ペンギン先生 ペンギン先生
# 見出し1、## 見出し2、- リスト項目、**太字**、*斜体*、[リンクテキスト](URL)、```コードブロック```。これだけ覚えれば大抵のドキュメントは書ける。画像は![代替テキスト](画像URL)で挿入。テーブルは| 列1 | 列2 |のようにパイプで区切るよ
ひよこ ひよこ
Markdownの方言が多いって聞くけど？
ペンギン先生 ペンギン先生
元のMarkdownは仕様が曖昧で、GitHub Flavored Markdown（GFM）、CommonMark、Pandoc拡張など派生が多い。テーブル、タスクリスト（- [ ]）、脚注、数式（KaTeX/MathJax）のサポート状況がサービスによって異なる。GitHubでドキュメントを書くならGFMの仕様を確認しておくといいよ
ひよこ ひよこ
Markdownエディタのおすすめは？
ペンギン先生 ペンギン先生
VS Code + Markdown Preview Enhanced（リアルタイムプレビュー）が無料で最強。Typora（有料）はWYSIWYGで書ける。Obsidianはナレッジベース構築に特化。Notion はMarkdownライクな記法で書けるけど独自拡張が多い。ブログやドキュメントならAstro + MDXでMarkdown内にコンポーネントを埋め込めるよ
ペンギン
まとめ：ざっくりこれだけ覚えればOK！
「Markdown」って出てきたら「テキストで簡単に書式付き文書が書ける軽量マークアップ言語」と思えればだいたいOK！
📖 おまけ：英語の意味
「Markdown」 ＝ マークダウン
💬 HTMLの「Markup」のダジャレ。John Gruberが2004年に発表。「書くのも読むのも楽」が設計思想だよ
🔗 あわせて読みたい
← 用語集にもどる