変更履歴
MkDocsで ==text== という記法を使って==ハイライト==(マーカーを引くような強調)を表示するには、Markdown拡張機能の pymdownx.mark を有効にする必要があります。
既に mkdocs.yml の設定内に pymdownx.mark は記述されていますので、あとは**「見た目(色)」をCSSで指定するだけ**で反映されます。
手順:CSSでハイライトの色をつける¶
デフォルトの mkdocs テーマでは、== で囲った部分は HTML の <mark> タグに変換されますが、標準では色がついていない(あるいは地味な)場合があります。
1. styles/custom.css に追記¶
すでにお使いの styles/custom.css に、以下のコードを追加してください。
CSS
/* ==強調== の見た目をカスタマイズ */
mark {
background-color: #ffff00; /* 黄色のマーカー */
color: #000; /* 文字色は黒 */
padding: 2px 4px; /* 少し余白を持たせる */
border-radius: 2px; /* 角を少し丸くする */
font-weight: bold; /* 太字にする(お好みで) */
}
2. Markdownでの書き方¶
あとは、.md ファイル内で以下のように書くだけです。
もしこれでも変わらない場合¶
mkdocs.yml の設定が正しく読み込まれているか、以下の点を確認してください。
- インデントの確認:
markdown_extensionsの下の- pymdownx.markが正しく字下げされているか見てみてください。 - ブラウザの更新:
CSSを書き換えた後は、ブラウザで
Ctrl + F5(強力な更新)を押してキャッシュをクリアしてください。 - extra_css のパス:
mkdocs.ymlでextra_cssにstyles/custom.cssが正しく指定されていることを確認してください。