title: “Markdown” aliases:
- “マークダウン” status: researched tags:
- “wikidig” sources:
- “https://en.wikipedia.org/wiki/Markdown”
- “https://wikidig.oqzl.net/”
プレーンテキストで見出し・箇条書き・リンクなどを記述する軽量マークアップ言語。人がそのまま読める書式と、HTMLなどへ変換できる構造を両立する。
概要
Markdownは、通常のテキストエディタで整形済み文書を書くための軽量マークアップ言語である。2004年にJohn Gruberが作成した。拡張子には .md や .markdown が使われる。
書き方と変換
# による見出し、- による箇条書き、[表示名](URL) によるリンク、**強調** などの記法を使う。Markdownプロセッサが記述を解釈し、主にHTMLへ変換して表示する。
用途と注意点
README、技術文書、ブログ、フォーラムなどで広く使われる。簡潔で差分管理しやすいため、Gitで管理する文書の正本にも向く。一方で原仕様には曖昧さがあり、表・脚注・タスクリストなどの対応は実装ごとに異なる。互換性が必要な場合はCommonMarkやGitHub Flavored Markdownなど、対象環境の仕様を確認する。
Related concepts
- Git — Markdownファイルの変更履歴を管理し、共同編集やレビューを可能にする。
- CommonMark — Markdownの曖昧な解釈を減らすための仕様とテスト群。
- HTML — Markdown文書の代表的な変換先。