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

Markdownファイル とは?

最終更新:
💡 「#」や「**」で書式を指定するシンプルな文書ファイル

Markdown記法で文書の構造や書式を表すプレーンテキストファイル。見出しやリストなどを簡単な記号で書き、対応するツールでHTMLなどへ変換して表示できる。

📌 このページのポイント
Markdown:テキストと表示を比較 ソース(.md) 表示結果 # 見出し **太字** - 項目 [リンク](url) `code` 見出し 太字 ● 項目 リンク code 変換 ツールが記号を読み取り、書式付きで表示 拡張記法や見た目はツールによって異なる
青は元のテキスト、緑はHTML等に変換した表示例、橙の矢印は変換。ファイルの拡張子だけで書式が付くのではなく、対応するエディタやサイトの処理が必要です。
ひよこ ひよこ
Markdownってどんなもの?
ペンギン先生 ペンギン先生
テキストに「# 見出し」「**太字**」「- リスト」などを書いて、文書の構造や書式を表す記法だよ。ファイル自体は普通のテキスト。対応するツールが読み取って、HTMLなどの書式付きの表示に変換するんだ。
ひよこ ひよこ
HTMLで書くより何がいいの?
ペンギン先生 ペンギン先生
見出しをHTMLのタグで囲まず、短い記号で書けるよ。変換前でも文書として読みやすいことが設計目標なんだ。ファイルをテキストエディタで編集でき、Gitで変更を追うこともできるね。
ひよこ ひよこ
.mdにすれば自動で書式が付く?
ペンギン先生 ペンギン先生
拡張子はファイルの種類を知らせる目印だよ。文字が自動で書式付きになるのではなく、エディタのプレビューやサイトの変換処理が必要。表示のデザインも、使うツールやCSSで変わるんだ。
ひよこ ひよこ
YAML Front Matterって何?
ペンギン先生 ペンギン先生
Astroなどのツールが、文書の先頭でタイトルや日付などを受け取るメタデータの仕組みだよ。YAMLでは区切り行の間に項目を改行して書く。このサイトでも使っているけど、Markdown本文そのものの必須記法ではないんだ。
ひよこ ひよこ
どのツールでも同じ記法が使える?
ペンギン先生 ペンギン先生
基本の見出しやリストは共通でも、拡張は違うよ。GFMはCommonMarkを基にしたGitHubの仕様で、表やタスクリストなどを追加している。他のツールで同じ表示になるとは限らないから、使う場所の対応記法を確認しよう。
ペンギン
まとめ:ざっくりこれだけ覚えればOK!
「Markdownファイル」って出てきたら「記号で見出しや書式を書くテキスト文書」と思えばだいたいOK!
📖 おまけ:英語の意味
「Markdown」 = プレーンテキストで文書の書式を書く記法
💬 John Gruberが公開した記法と変換ツールの名前。元の文書をテキストのまま読みやすくすることが設計目標として説明されているよ。

参考資料

← 用語集にもどる