Using +alerts and +citations?

[reagle]

I'm using Obsidian to edit a pelican blog which uses pandoc-reader plugin. This allows me to make use of [@citations2013], but I'd also like to use alerts (e.g., >[!NOTE]). The formats, however, don't overlap. +citations can be used with markdown, and +alerts with commonmark_x, but there's no intersection. Any ideas?

[rnwst]

Looks like alerts are converted to Divs of class note, tip, important, warning, or caution. Converting the following gfm to native:

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

(via pandoc test.md -f gfm -t native) yields

[ Div
    ( "" , [ "note" ] , [] )
    [ Div ( "" , [ "title" ] , [] ) [ Para [ Str "Note" ] ]
    , Para
        [ Str "Useful"
        , Space
        , Str "information"
        , Space
        , Str "that"
        , Space
        , Str "users"
        , Space
        , Str "should"
        , Space
        , Str "know,"
        , Space
        , Str "even"
        , Space
        , Str "when"
        , Space
        , Str "skimming"
        , Space
        , Str "content."
        ]
    ]
]

You could manually recreate this structure in pandoc's markdown as follows:

::: note
::: title
Useful information that users should know, even when skimming content. 
:::
:::

I suppose the structure you need really depends on your CSS.

If you really want to use the [!NOTE] syntax, you could also write a Lua filter to parse these into the required AST structure.

[jgm]

There's an issue on the tracker for supporting alerts in pandoc's markdown.
And there's an issue on jgm/commonmark-hs tracker for supporting citations in commonmark.

[reagle]

For my reference, that is: #9716 and jgm/commonmark-hs#15

[iandol]

I have a filter that converts > [!NOTE] etc. for Pandoc flavour for several outputs (I needed it for typst, but you can check how it handles other outputs):

https://github.com/iandol/dotpandoc/blob/master/filters/alerts.lua

➪ pandoc -L alerts.lua -f markdown -t html5

Some content.

> [!NOTE]
> This is a note.

Some normal content

::: note
A note using fenced div
:::

Some content.

<p>Some content.</p>
<div class="note" data-custom-style="Note">
<p>💡 Note<br />
This is a note.</p>
</div>
<p>Some normal content</p>
<div class="note" data-custom-style="Note">
<p>💡 Note<br />
A note using fenced div</p>
</div>
<p>Some content.</p>

[reagle]

Thanks for this, I might adapt it at some point.