Markdown-Edit icon indicating copy to clipboard operation
Markdown-Edit copied to clipboard

Request: Doxygen-style markdown

Open c-lipka opened this issue 8 years ago • 1 comments

I'm using Doxygen to document a somewhat large project, including various pages that are separate from the actual source code; for these I've chosen Markdown, since of all the input formats supported by Doxygen it is the easiest to read and write with a plain ASCII editor.

However, Doxygen's flavour of Markdown is distinctive from both GitHub and CommonMark; for example it supports tables like GitHub flavour, but its line break style matches that of CommonMark.

There are several other extensions, as documented in the Doxygen manual: http://www.stack.nl/~dimitri/doxygen/manual/markdown.html


Also, while Doxygen can read plain Markdown files (and that's what I'm mostly using for the standalone stuff), it also supports Markdown embedded in C/C++ (and other) source code comments, so the icing on the cake with a cherry on top would be if a Doxygen mode in Markdown Edit would also support this format: Rendering most of the text as code, except for blocks surrounded by /** and */ or with a leading /// on each line which would be interpreted as regular (Doxygen-flavoured) Markdown.

c-lipka avatar Dec 18 '16 16:12 c-lipka

Is there a markdown processor specific to Doxygen? If there is and it can be command line driven, there is a way to get MDE to use it.

mike-ward avatar Dec 19 '16 13:12 mike-ward