起こった現象

Githubpagesに立てたJekyllテーマ「minima」において、HTMLの詳細折りたたみ要素である<details>の中でMarkdownの箇条書きが作れなかった。

詳細折り畳み要素の例

<details open>
  <summary>買い物リスト</summary>
  
1. じゃがいも
1. にんじん
1. たまねぎ
</details>

【実行結果※Qiitaでは箇条書きとして表示できます】

買い物リスト

解決方法

JekyllのパーサーであるKramdownではHTML内のMarkdown記法はパースされない。このときはHTMLタグにmarkdown="1"のオプションを入れるとうまくいく。

詳細折り畳み要素+markdown="1"

<details open markdown="1">
  <summary>買い物リスト</summary>
  
1. じゃがいも
1. にんじん
1. たまねぎ
</details>

買い物リスト

下の記事ではconfig.ymlもしくは各ページ内でparse_block_htmlのオプションを有効にすると書いてあるが、うまくいかなかった。

下の記事ではconfig.yml内でMarkdownのパーサーをCommonMarkGhPagesとして設定すると書いてあるが、うまくいかなかった。