1Dokuwiki Commonmark Plugin 2=========================== 3 4## Description 5This is another plugin for parsing Commonmark / Markdown document in Dokuwiki. 6 7While there are many Markdown plugins (for example, [markdownu](https://www.dokuwiki.org/plugin:markdowku), [mdpage](https://www.dokuwiki.org/plugin:mdpage)) available, this plugin processes Markdown text in different approach: 8 91. check that Markdown indicator ('\<!DOCTYPE markdown\>') is included on the document 102. if exists, parses entire document and renders to DW syntax 113. After pre-rendering, passes the result to DW parser and process as usual 12 13## Compatibility 14Commonmark plugin aims for complete compatiblity of Markdown in Dokuwiki. Most Markdown syntax have corresponding DW syntax, so it will work without problem; but in some cases, Markdown syntax do not matches DW specification one-by-one, or vice versa. Here is a list of known ambiguities between Commonmark and Dokuwiki, and its implements in the plugin: 15 16- Since DW do not parses raw HTML without `htmlok` config, [HTML blocks](https://spec.commonmark.org/0.30/#html-blocks) is passed. 17- When adding `html` as info string in [Fenced code blocks](https://spec.commonmark.org/0.30/#fenced-code-blocks), it parse to DW's [\<HTML\>](https://www.dokuwiki.org/wiki:syntax#embedding_html_and_php) block; In case of `nowiki`, `<nowiki>` syntax will be parsed; if `dokuwiki`, raw DW code will be passed. 18 19Commonmark plugin would conflit with other markdown-related plugins, including Mdpage. 20 21Due to the concept, section edit will not work, or at least recognize the section as broken snippet rather than expected. This bug will be fixed in later version. 22 23## License 24 25- icons: Apache License from https://www.iconbolt.com/ 26