Integrate callouts?

[aubertc]

Callouts are nice feature supported by quartz (and github) that turns

> [!NOTE]  
> Highlights information that users should take into account, even when skimming.

into

Note

Highlights information that users should take into account, even when skimming.

or (more precisely) as

However, callouts are not supported by pandoc, so they are lost when converting to markdown.
Even if those callouts were preserved, they would only be correctly rendered on the website, as pandoc cannot convert callouts for pdf, odt and docx documents.

A current workaround is to use a table, as follows:

| ⚠️ Warning                                                                                                                                                                                              |
|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| This is a warning. |

which is rendered as

⚠️ Warning
This is a warning.

or (more precisely) as

Integrating callouts could be nice, and possible sources of inspiration includes:

• https://quartz.jzhao.xyz/features/callouts,
• https://gist.github.com/jskherman/8e721302e67d308e8a81f3df84f01f20,
• https://www.reddit.com/r/LaTeX/comments/1baudg4/callouts_in_latex/,
• https://tex.stackexchange.com/questions/714908/newcommand-syntax-with-callouts,
• https://forum.obsidian.md/t/rendering-callouts-similarly-in-pandoc/40020/6,
• https://raw.githubusercontent.com/kdheepak/kdheepak.github.io/main/blog/pandoc-lua-filter-for-alerts/index.md.

[aubertc]

With 981ab06 the warning sign is properly integrated into the pdf outputs.

[whmarsh87]

In many ways, the callout is just an integration of an image to that location, with the specific image being determined by which callout is used. Does pandoc have issues with inserted images? If not, we could just get a repository of images for the types of callouts and do them as follows:

![insertion of our callout image from our personal repository of images]
what is being called out

It would make it to where we would have to maintain our own group of images for callouts, but it might also make them more compatible with pandoc.

[whmarsh87]

Also, comparing the Quartz to the pandoc, I think the issue lies with where they want the !. In your Quartz example, it is within the brackets, [!], but pandoc has it prior to ![]

[aubertc]

The ![]… syntax is for images, the syntax you are looking for comes from alerts, cf. https://pandoc.org/MANUAL.html#extension-alerts

[aubertc]

pandoc has an extension for that but it doesn't look great in pdfs

or in odt

so I suggest we keep the "workaround" with the table, in pdf

or odt