【まーくだうんふぁいる】

Markdownファイル とは?

💡 「#」や「**」で書式を指定するシンプルな文書ファイル
📌 このページのポイント
Markdownファイル ― 記法と表示の比較 ソース (.md) # 見出し1 ## 見出し2 普通のテキスト **太字** *斜体* - リスト項目1 - リスト項目2 [リンク](url) `コード` 変換 表示結果 (HTML) 見出し1 見出し2 普通のテキスト 太字 斜体 ● リスト項目1 ● リスト項目2 リンク コード
Markdownファイルのイメージ
ひよこ ひよこ

Markdownってどんなもの?

ペンギン先生 ペンギン先生

テキストに「# 見出し」「**太字**」「[リンク](URL)」といった記号を付けて構造を表現する形式だよ。GitHubで読むと自動的にHTMLに変換されて見やすく表示される。このサイトの記事もMarkdown(.md)で書かれているよ。

ひよこ ひよこ

HTMLで書くより何がいいの?

ペンギン先生 ペンギン先生

書きやすく読みやすい。HTMLは「

見出し

」と書く必要があるが、Markdownは「# 見出し」だけでいい。プレーンテキストなのでGitで差分が見やすく、バージョン管理と相性がいい。

ひよこ ひよこ

おもしろい!YAML Front Matterって何?

ペンギン先生 ペンギン先生

Markdownファイルの先頭に「---」で囲んでYAML形式のメタデータを書く形式。このサイトのコンテンツファイルも「---title: タイトル\nlevel: basic\n---」というFront Matterで始まっている。AstroやHugoなどのSSGがこれを読んでページを生成する。

ひよこ ひよこ

Markdownってブログ以外でも使われてるの?

ペンギン先生 ペンギン先生

GitHubのREADME、NotionドキュメントSlackのメッセージ書式、技術書の原稿など至るところで使われているよ。実はMarkdownには「CommonMark」「GitHub Flavored Markdown(GFM)」など複数の方言があって、テーブルやチェックボックスが使えるかどうかが微妙に違うんだ。GFMが事実上の標準になりつつあるね。

ひよこ ひよこ

えっ、方言があるんだ!知らなかった!

ペンギン先生 ペンギン先生

そうなんだ。もう一つ豆知識として、Markdownの生みの親ジョン・グルーバーは「HTMLを書くのが面倒」という動機で2004年に作ったんだけど、正式な仕様をきちんと定義しなかったんだ。だから各ツールが独自に拡張して方言が生まれた経緯があるよ。

ペンギン
まとめ:ざっくりこれだけ覚えればOK!
Markdownファイルって出てきたら「#や**などの記号で書式を指定するプレーンテキスト文書、.md拡張子GitHub等で広く使われる」と思えばOK!
📖 おまけ:英語の意味
「Markdown」 = マークアップ(Markup)の軽量版
💬 2004年にJohn Gruberが考案。HTMLを「マークアップ(Markup)」言語と呼ぶのに対し、より軽量・シンプルな「マークダウン(Markdown)」として命名
← 用語集にもどる