Wishlist: Markdown syntax

[danakj]

hdoc supports (some of) doxygen syntax, which makes sense.

But instead, I would like to write documentation in the syntax of Rustdoc, which doesn't require a lot of keywords. Instead it uses markdown syntax: https://doc.rust-lang.org/rust-by-example/meta/doc.html#doc-comments.

This could be a runtime option since being backward compat with doxygen seems like an important thing.

An example comment that uses the # Header syntax in markdown, in this case # Safety which should appear on its own line bolded then: https://docs.hdoc.io/danakj/subspace/r3642BA3A7BB0524E.html#D5D58BB0594AEC21

[hdoc]

Thank you for the suggestion.

There is an upcoming refactor of the comment parsing system where we're hoping to support richer forms of markup, including Markdown, in comments.

[Wmbat]

Allo !

Has there been updates on this ? I think it would be extremely beneficial to library documentations if we could have access to richer syntax to specific examples and other miscellaneous information about the code ?

Thank you

[hdoc]

Hello,

This is something we are working on, however we can't provide an exact date that it will be ready right now.

Thank you