• Home
  • History
  • Annotate
Name Date Size #Lines LOC




README.mdH A D12-Jul-20211.5 KiB1913

action.phpH A D12-Jul-20211.3 KiB4215

composer.jsonH A D12-Jul-2021645 3232

composer.lockH A D01-Jul-20214.3 KiB121120

plugin.info.txtH A D08-Jul-2021209 77


1Dokuwiki Commonmark Plugin
4## Description
5This is another plugin for parsing Commonmark / Markdown document in Dokuwiki.
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:
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
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:
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.
19Commonmark plugin would conflit with other markdown-related plugins, including Mdpage.