Feature Request: Support Alerts/Callouts/Admonitions?

[theory]

[Apologies if this is not the place to submit request/ideas/etc. Happy to redirect elsewhere if preferred.]

GFM (and other implementations, too) supports alerts, e.g.,

> [!NOTE]
> Useful information that users should know, even when skimming content.

Which renders as (some newlines added to improve legibility):

<div class="markdown-alert markdown-alert-note" dir="auto">
  <p class="markdown-alert-title" dir="auto">
    <svg class="octicon octicon-info mr-2" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true"><path d="M0 8a8 8 0 1 1 16 0A8 8 0 0 1 0 8Zm8-6.5a6.5 6.5 0 1 0 0 13 6.5 6.5 0 0 0 0-13ZM6.5 7.75A.75.75 0 0 1 7.25 7h1a.75.75 0 0 1 .75.75v2.75h.25a.75.75 0 0 1 0 1.5h-2a.75.75 0 0 1 0-1.5h.25v-2h-.25a.75.75 0 0 1-.75-.75ZM8 6a1 1 0 1 1 0-2 1 1 0 0 1 0 2Z"></path></svg>
    Note
  </p>
  <p dir="auto">Useful information that users should know, even when skimming content.</p>
</div>

Which seems like overkill, frankly. Anyway, would be nice to support this syntax, perhaps without the SVG, something like:

<div class="markdown-alert markdown-alert-note" dir="auto">
  <p class="markdown-alert-title" dir="auto">Note</p>
  <p dir="auto">Useful information that users should know, even when skimming content.</p>
</div>

[Orc]

Ooof, that's a *hideous* piece of syntax. I'd take a patch to implement it, but jesus it's awful.

…

-jessica l. parsons

On Dec 16, 2025, at 2:19 PM, David E. Wheeler ***@***.***> wrote: theory created an issue (Orc/discount#300) <#300> [Apologies if this is not the place to submit request/ideas/etc. Happy to redirect elsewhere if preferred.] GFM (and other implementations, too) supports alerts <https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#alerts>, e.g., > [!NOTE] > Useful information that users should know, even when skimming content. Which renders as <https://github.com/unindented/unindented-notes/blob/56d758e5416f392758ccf4c41f5f5ab505c0838f/notes/reference_alerts_in_github_flavored_markdown.org#preview> (some newlines added to improve legibility): <div class="markdown-alert markdown-alert-note" dir="auto"> <p class="markdown-alert-title" dir="auto"> <svg class="octicon octicon-info mr-2" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true"><path d="M0 8a8 8 0 1 1 16 0A8 8 0 0 1 0 8Zm8-6.5a6.5 6.5 0 1 0 0 13 6.5 6.5 0 0 0 0-13ZM6.5 7.75A.75.75 0 0 1 7.25 7h1a.75.75 0 0 1 .75.75v2.75h.25a.75.75 0 0 1 0 1.5h-2a.75.75 0 0 1 0-1.5h.25v-2h-.25a.75.75 0 0 1-.75-.75ZM8 6a1 1 0 1 1 0-2 1 1 0 0 1 0 2Z"></path></svg> Note </p> <p dir="auto">Useful information that users should know, even when skimming content.</p> </div> Which seems like overkill, frankly. Anyway, would be nice to support this syntax, perhaps without the SVG, something like: <div class="markdown-alert markdown-alert-note" dir="auto"> <p class="markdown-alert-title" dir="auto">Note</p> <p dir="auto">Useful information that users should know, even when skimming content.</p> </div> — Reply to this email directly, view it on GitHub <#300>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AAAE5ATGKBUGB6AJZXIPVS34CCAPBAVCNFSM6AAAAACPH2PF52VHI2DSMVQWIX3LMV43ASLTON2WKOZTG4ZTMNJTGM2DIMA>. You are receiving this because you are subscribed to this thread.