Add Support for Obsidian Callouts (Admonitions)

[RoyiAvital]

Lately Obsidian has added support for Callouts (Admonitions).

Though the didn't chose the most used syntax, it would be great to add support for this.

I'd go even farther and strive for feature / syntax compatibility with Obsidian.

[toastal]

Obsidian's syntax is mostly compatible with Microsoft's Markdown but will probably conflict with admonitions in Markdown for CommonMark RFC+Docusaurus+Remark, MkDocs, Mozilla Developer Network, and Microsoft GitHub's broken implimentation.

But at least admonitions are standardized in AsciiDoc and reStructuredText.

[RoyiAvital]

Maybe a YAML to configure the syntax for them?
Anyhow, I think Obsidian compatibility, at least under a flag, is a major feature.

[toastal]

And I would say AsciiDoc support should be a major feature 😅. It could be less trouble that trying to support 5-6 different Markdown syntax forks.

[RoyiAvital]

The idea I raised is that emanote main feature would be a static site generator for personal knowledge managers.
So you need to chose one, better one which is popular, and have some kind of a compatibility with it.

If Obsidian supported AsciiDoc I would be the first to support.
But none of the PKM's I'm aware of supports AsciiDoc.
Do you know any?

[srid]

It is time to implement this: #465

And I think we should choose one format and stick with it. I propose to go with Obsidian.

[RoyiAvital]

I agree with @toastal . It must work as close can be to standards.
The option to support the Obsidian syntax should be an Opt In option.

Though, in my case, this is what I will be using as I basically use emanote as a site generator for Obsidian.

[srid]

I'll consider supporting both.

(We are migrating a Docusaurus site to Emanote, so this would be useful actually)

[srid]

One problem with docusaurus format is we can't support callouts with custom types: https://docusaurus.io/docs/markdown-features/admonitions#specifying-title

Because commonmark-hs (the Markdown parser used by Emanote) doesn't recognize that syntax. ie., Pandoc already understands ::: blocks is not true if those blocks contain a custom title.

[srid]

Demo: https://nixos.asia/en/blog/nix-rapid

Draft PR: #466

[toastal]

Consider adding role="note" to callouts for better semantics/accessibility