Post

GitHub Flavored Markdown Admonitions

GitHub Pages上では,警告がレンダリングされません(引用として扱われます).

1
2
> [!NOTE]
> foo

⬇️

[!NOTE] foo

GitHub Flavored Markdown Admonitionsを使用するとレンダリングされるようになります.

1
2
> [!NOTE]
> foo

⬇️

Note

foo

少し問題がありましたが,よくなりました(https://github.com/Helveg/jekyll-gfm-admonitions/issues/7https://github.com/Helveg/jekyll-gfm-admonitions/issues/9).

警告の終わりが引用,GitHub上での警告の終わりと違います(https://github.com/Helveg/jekyll-gfm-admonitions/pull/8#issuecomment-2696180859).楽に解析するために,試しに,ジェネレータとして作成されているGitHub Flavored Markdown Admonitionsをコンバータとして書き直し,https://manabu-nakamura.github.io/で使ってみています(jekyll-gfm-admonitions.rbGemfile_config.yml).コンバータはページ全体にアクセスできないようですが,実害はないようです.引用,警告の直後に見出しがある場合の引用,警告の終わりが気になります.MarkdownプロセッサとしてkramdownでなくGFMを使えば大丈夫ですが,Chirpyでは使えません(https://manabu-nakamura.github.io/jekyll-gfm-admonitions2/https://docs.github.com/ja/pages/setting-up-a-github-pages-site-with-jekyll/setting-a-markdown-processor-for-your-github-pages-site-using-jekyll).

引用,警告が入れ子になっている場合,まじめに解析するのが面倒です.しかし,まじめに解析しなくても,出力は汚いですが,実害はありません.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
> foo
> bar
  baz
qux

quux
> [!NOTE]
> foo
> bar
  baz
qux

quux
> foo
> bar
# H1
> [!NOTE]
> foo
> bar
# H1

> [!NOTE]
> > [!NOTE]
> > foo

> foo
> > [!NOTE]
> > bar

⬇️

foo bar baz qux

quux

Note

foo bar baz qux

quux

foo bar

H1

[!NOTE] foo bar

H1

Note

[!NOTE] foo

foo

Note

bar

余談ですが,Chirpyにはプロンプトもあります.

1
2
3
4
5
6
7
8
> tip
{: .prompt-tip }
> info
{: .prompt-info }
> warning
{: .prompt-warning }
> danger
{: .prompt-danger }

⬇️

tip

info

warning

danger

This post is licensed under CC BY 4.0 by the author.