Markdown（マークダウン／md）

Markdown（マークダウン）とは、「#」や「*」などの簡単な記号を使って、見出しや箇条書きといった文書の構造を表現できる記法です。テキストだけで手軽に書けるのに、変換すればきれいに整形されたHTMLなどとして表示できるのが特徴で、READMEファイルや技術ブログ、チャットツールなど、ITの世界で広く使われています。

現実世界でいえば、手書きメモに付ける印のようなものです。メモを取るとき、大事な見出しに丸を付けたり、項目の頭に「・」を書いたりしますよね。Markdownはそれをルール化したもので、「#を付けたら見出し」「-を付けたら箇条書き」のように、誰が書いても同じ意味に解釈できるようになっています。

Markdownの書き方の例

代表的な記法をいくつか紹介します。

なぜMarkdownが使われるのか

• 書くのが速い
  マウスでボタンを押して装飾する必要がなく、キーボードだけで書き続けられます。
• ただのテキストファイル
  特別なソフトがなくてもメモ帳で開けて、壊れにくく、バージョン管理（Git）とも相性抜群です。
• そのままでも読める
  変換しなくても、記号付きのテキストとして人間が普通に読めます。
• 多くのサービスが対応
  GitHub、Slack、Notion、Qiita、WordPressなど、対応サービスが非常に多いです。

MarkdownとHTMLの関係

Webページを記述するHTMLは「<h1>見出し</h1>」のようにタグで文書構造を表しますが、タグが多くて人間には書きにくい面があります。Markdownは、このHTMLを「人間が書きやすい形」に簡略化したものといえます。Markdownで書かれた文書は、ツールによってHTMLに変換されてからブラウザに表示されるのが一般的です。細かい装飾はHTMLに及びませんが、日常の文書には十分な表現力があります。

Markdownを使うときの注意点

Markdownには厳密な統一規格がなく、サービスによって書ける記法が少しずつ違います（GitHub Flavored Markdownなどの「方言」があります）。表や打ち消し線などの拡張記法は、使う場所で対応しているか確認しましょう。また、拡張子は「.md」が一般的です。

あわせて知っておきたい用語

• HTML：
  Webページを記述するための言語。Markdownは変換によってHTMLになります。
• テキストファイル：
  文字情報だけを含むファイル。Markdownファイルの正体はただのテキストです。
• Git：
  ファイルの変更履歴を管理する仕組み。テキストであるMarkdownは差分管理と相性が良いです。
• README：
  ソフトの説明書きファイル。GitHubではMarkdownで書くのが定番です。