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


技術ブログの記事やドキュメントを書くときは、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コードとプレビューを同時に確認できます。
テキストやマークダウン記号を左パネルに自由に入力して、リアルタイムに変換されるHTMLの生マークアップタグとスタイル付きのレンダリングプレビューをその場で確認・取得してみてください。
つまずきやすいポイント
| 状況 | 原因 |
|---|---|
太字(**)が効かない | 閉じ記号の直後に空白や句読点を挟まず文字が続いている |
| コードブロック内のマークダウンがそのまま変換される | コードフェンス(```)が正しく閉じられていない |
| バッククォートを含むテキストが崩れる | バッククォートの数が合わず、コード範囲の認識がずれる |
| 画像が表示されない |  のURLが相対パスなのに、実際のファイル位置と異なる |
まとめ
マークダウンはWebブラウザが直接読めない記法なので、HTMLに変換する工程が必ず一度は必要です。見出し・強調・リンク・コードといった基本記法は変換ツールごとにルールがよく似ていますが、強調記号がハングルの助詞の前で効かないように、細かい動作が分かれるポイントもあります。変換されたHTMLには既定のスタイルがないため、タイポグラフィ用のCSSを別途適用しないと見栄えよく仕上がりません。
テキストやマークダウン記号を左パネルに自由に入力して、リアルタイムに変換されるHTMLの生マークアップタグとスタイル付きのレンダリングプレビューをその場で確認・取得してみてください。
よくある質問
マークダウンとHTMLは、どちらを先に使えばいいですか?
文章を書く段階ではマークダウンが楽です。タグを直接打たなくて済みますし、テキストファイルのままでも読みやすいです。Webに公開するときだけHTMLに変換すれば十分です。
変換ツールによって結果が少しずつ違うのはなぜですか?
マークダウンにはCommonMarkのような標準規格がありますが、変換ツールごとに拡張記法や例外の扱いが少しずつ異なります。同じ原文でも変換ツールを変えると、出力されるHTMLが微妙に変わることがあります。
この記事は韓国語の原文をもとに作成しています。 韓国語の原文を読む