Problem
doc-kit currently does not support GitHub-style alert syntax (e.g. > [!NOTE], > [!WARNING]).
These are rendered as plain blockquotes since remark-gfm explicitly does not cover this syntax.
Proposal
Integrate a plugin like remark-alerts into the doc-kit pipeline to parse and render these blocks correctly.
Example
Input:
Current output: plain blockquote
Expected output: styled alert div, matching GitHub's rendering
Open to discussion on which plugin is the best fit if there are alternatives.
Problem
doc-kitcurrently does not support GitHub-style alert syntax (e.g.> [!NOTE],> [!WARNING]).These are rendered as plain blockquotes since
remark-gfmexplicitly does not cover this syntax.Proposal
Integrate a plugin like remark-alerts into the doc-kit pipeline to parse and render these blocks correctly.
Example
Input:
Note
This is a note.
Current output: plain blockquote
Expected output: styled alert div, matching GitHub's rendering
Open to discussion on which plugin is the best fit if there are alternatives.