Markdown → HTML

マークダウンって何？はじめての方にもわかりやすく解説

マークダウン(Markdown)は、シンプルな記号でフォーマット付きの文書を書ける軽量マークアップ言語です。GitHub、ブログ、Notionなど、いろんな場所で使われています。# で見出し、** で太字、- で箇条書き。覚えてしまえばHTMLより圧倒的に速く書けますよ。

マークダウンとHTMLの違い

マークダウンはHTMLに変換されて表示されます。直接HTMLを書くよりもはるかに読みやすく、ブログ記事やドキュメントの執筆に向いています。ただし、細かいスタイル調整が必要な場面では直接HTMLを使った方が良い場合もあります。

基本の文法をおさらい

マークダウンの文法はとてもシンプルです。#の数で見出しレベル(h1~h6)を指定し、**テキスト**で太字、*テキスト*でイタリックになります。箇条書きは-か*で始めるだけ。リンクは[表示テキスト](URL)、画像はの形式です。コードの挿入はバッククォート(`)で囲めばOK。複数行のコードブロックは3つのバッククォートで挟みます。慣れると手が勝手に動くようになりますよ。

どこでマークダウンが使われている？

GitHubのREADMEやIssue、Pull Requestの説明はすべてマークダウンです。NotionやObsidianなどのメモアプリ、Slackのメッセージでもマークダウン記法が使えますよね。JekyllやHugo、Astroといった静的サイトジェネレーターでは、ブログ記事をマークダウンで書くのが主流です。技術ドキュメントからちょっとしたメモまで、今やマークダウンはエンジニアの共通言語と言っても過言ではないでしょう。

読みやすいマークダウンを書くコツ

見出しは順番通りに使うのが基本です。h1のあとにいきなりh3を使うと文書構造が崩れてしまいます。段落の間には空行を入れると、ぐっと読みやすくなりますよ。コードブロックではプログラミング言語名を指定すると、シンタックスハイライトが効いて見やすくなります。長いドキュメントには目次をつけておくと親切ですね。投稿前にプレビューで表示を確認する習慣をつけると、フォーマット崩れを防げます。