マークダウンHTML変換のルールとCSS装飾を解説

公開ツールMarkdown ↔ HTML リアルタイム変換ツール

目次
  1. マークダウン記法がHTMLタグに変わるルール
  2. 変換されたHTMLをCSSで装飾する方法
  3. つまずきやすいポイント
  4. まとめ
  5. よくある質問

技術ブログの記事やドキュメントを書くときは、HTMLタグを直接打つのではなく、読みやすいマークダウン(Markdown)記法を使うことが多いでしょう。問題は、Webブラウザがマークダウン記法をそのまま描画してくれないことです。

画面に表示するには、マークダウンのテキストをHTMLタグに変換する工程が一度必要になります。この記事では、マークダウンがどんなルールでHTMLに変わるのか、変換されたHTMLをどうCSSで装飾するのかを整理します。


マークダウン記法がHTMLタグに変わるルール

マークダウン変換ツールは、原文の中からマークダウン特有の記号パターンを見つけて、対応するHTMLタグに置き換えます。よく使う記法と、実際に変換されるタグは次のとおりです。

マークダウン記法変換されるHTML
# 〜 ######(見出し)<h1> 〜 <h6>
**太字**<strong>太字</strong>
*斜体*<em>斜体</em>
[テキスト](URL)<a href="URL">テキスト</a>
バッククォートで囲んだテキスト<code>テキスト</code>

細かいルールは変換ツールごとに少しずつ異なります。たとえば、太字(**)で囲んだ部分のすぐ後ろに空白を入れずにハングルの助詞が続く場合、つまり閉じ記号の直後に空白や句読点を挟まず文字が続く場合、一部の変換ツールでは強調として認識されず、アスタリスクがそのまま残ってしまいます。

強調が効かないときは、閉じの ** の後ろに空白を1つ入れてみると、ほとんどは解決します。

変換されたHTMLをCSSで装飾する方法

マークダウンを変換しただけではHTMLの既定スタイルそのままなので、余白がなく地味に見えます。可読性を高めるには、変換結果を包むコンテナにタイポグラフィ用のCSSを別途適用する必要があります。よく使う例は次のとおりです。

/* マークダウンのレンダリング結果を包む最上位コンテナ */
.markdown-body {
  line-height: 1.6;
  color: #24292e;
  font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica;
}

/* 見出しの下に控えめな区切り線を追加 */
.markdown-body h2 {
  padding-bottom: 0.3em;
  border-bottom: 1px solid #eaecef;
}

/* コード領域の可読性を補正 */
.markdown-body code {
  padding: 0.2em 0.4em;
  background-color: rgba(27, 31, 35, 0.05);
  border-radius: 3px;
  font-family: SFMono-Regular, Consolas, monospace;
}

毎回ターミナルで変換スクリプトを回す必要はありません。Markdown ↔ HTML リアルタイム変換ツールを使えば、左側で入力したマークダウンが右側にプレビュー画面とHTMLコードとしてすぐに表示されます。逆に、HTMLコードを貼り付けてマークダウンに戻すこともできます。

実際に変換してみたい方はこちら。 下の欄にマークダウンを入力すると、HTMLコードとプレビューを同時に確認できます。

Markdown ↔ HTML リアルタイム変換ツール

テキストやマークダウン記号を左パネルに自由に入力して、リアルタイムに変換されるHTMLの生マークアップタグとスタイル付きのレンダリングプレビューをその場で確認・取得してみてください。

つまずきやすいポイント

状況原因
太字(**)が効かない閉じ記号の直後に空白や句読点を挟まず文字が続いている
コードブロック内のマークダウンがそのまま変換されるコードフェンス(```)が正しく閉じられていない
バッククォートを含むテキストが崩れるバッククォートの数が合わず、コード範囲の認識がずれる
画像が表示されない![alt](URL) のURLが相対パスなのに、実際のファイル位置と異なる

まとめ

マークダウンはWebブラウザが直接読めない記法なので、HTMLに変換する工程が必ず一度は必要です。見出し・強調・リンク・コードといった基本記法は変換ツールごとにルールがよく似ていますが、強調記号がハングルの助詞の前で効かないように、細かい動作が分かれるポイントもあります。変換されたHTMLには既定のスタイルがないため、タイポグラフィ用のCSSを別途適用しないと見栄えよく仕上がりません。

Markdown ↔ HTML リアルタイム変換ツール

テキストやマークダウン記号を左パネルに自由に入力して、リアルタイムに変換されるHTMLの生マークアップタグとスタイル付きのレンダリングプレビューをその場で確認・取得してみてください。

よくある質問

マークダウンとHTMLは、どちらを先に使えばいいですか?

文章を書く段階ではマークダウンが楽です。タグを直接打たなくて済みますし、テキストファイルのままでも読みやすいです。Webに公開するときだけHTMLに変換すれば十分です。

変換ツールによって結果が少しずつ違うのはなぜですか?

マークダウンにはCommonMarkのような標準規格がありますが、変換ツールごとに拡張記法や例外の扱いが少しずつ異なります。同じ原文でも変換ツールを変えると、出力されるHTMLが微妙に変わることがあります。

この記事は韓国語の原文をもとに作成しています。 韓国語の原文を読む

関連記事

  1. マークダウン表・HTMLテーブル・JSON相互変換の仕組みマークダウン表・HTMLのtableタグ・JSON配列を相互変換するとき、見出し行の認識や列数のずれがどう処理されるかを実際の動作に沿って解説します。
  2. テキストファイルを結合する方法と文字化け防止分かれたテキスト(TXT)ファイルをまとめて結合する手順と、区切り文字・ファイル名ヘッダーのオプション、結合後に起こるEUC-KRの文字化けを避ける確認ポイントを解説します。
  3. モックJSONのダミーデータ生成とAPIテスト設計UUID・連番ID・仮のメールや乱数で作るダミーJSONの生成ロジックと、モックのネットワーク遅延を再現してAPIテストを進める際のチェックポイントを解説します。
  4. モールス信号 音の長さの公式とWeb Audio APIモールス信号の音の長さの公式(短点1・長点3)と、Web Audio APIのオシレーターでビープ音を合成する方法を解説します。周波数とWPMの考え方も整理します。
  5. モールス信号の変換方法とアルファベット対応表点(.)と線(-)の組み合わせで文字を表すモールス信号について、アルファベット・数字の対応表と、文字と単語を区切る変換ルールを解説します。
  6. 英語名のイニシャル変換|抽出ルールと大文字表記の基本姓と名の順序、大文字への統一、区切り記号の付け方など、英語のフルネームからイニシャルを作る手順と、航空券や署名まわりで迷いやすい点を整理して解説します。

関連ツール