Learn about DokuWiki
Learn about DokuWiki
This plugin will go before the overlapping DokuWiki syntax definitions and overrule them with Markdown specifications.
For patterns that are not part of Markdown, you can still use DokuWiki, e.g. you're still able to use DokuWiki tables.
This plugins tries to resemble Markdown as closely as possible and does not extend it. It is a best-effort implementation - I didn't try to match the Markdown test suite, but rather provide a look-alike handler for Markdown syntax, as Markdown itself is somewhat underspecified.
If you encounter any incompatibilities in this version, feel free to add them here or report them.
Due to the inner working of Markdown and DokuWiki, there are things which currently cannot be done with this plugin. I am working on getting this fixed. If you want to help, feel free to contact me (gnrp) in IRC.
All in all, this plugin is complete. Just when it comes to nesting things, i.e. putting things into each other, this plugin doesn't handle lists and blockquotes well.
This should be a complete list of current general incompatibilities. Everything else is a bug:
Please note that this plugin is not actively developed anymore!
You can find the whole release history on the plugin website.
Last update: 2017-02-19: Relese a new version. Compatibility with PHP 7.0 is now inside. I am sorry for the long delay with that. I had the code around, but testing was a bit difficult with PHP 7.0. However, it is released now.
There is a bug tracker online. Please note you have to log in anonymous (go to Login page, click “Fill out captcha”) before you can commit bugs. Also, you can write me an e-mail and I will enter the bug to the bug tracker.
This plugin is not complete yet. Incompatibilities are listed above at Known incompatibilities.
In the end, I want to extend this plugin to be able to handle different markdown flavours (esp. Github), with a switch in the configuration to choose between those all.
A switch like <no_markdown> will allow to avoid problems with existing native markup pages. (jseto) – I'll see what is possible, but I think it will be difficult to implement that. (gnrp 13-09-23)
The plugin editor does not work together with markdown. Either have the possibility to disable it, or even better, make it work with Markdown (Celano 13-08-08, reformatted by gnrp 13-09-23)
The plugin seem useful as we write in markdown but eventually need to use some DokuWiki syntax. I have to say that the wiki display markdown files created elsewhere by peoples using markdown editor and they doesn’t want to change to a new syntax. The idea is they work as they used to in markdown tools, and eventually had some DokuWiki synthax for some site related features and needs. I have three problems that prevent us to use the plugin which I hope could be improved.
If it used .md, I might be able to keep it synced with my .md files in dropbox.
The prior two plugins (markdown, markdownextra) work completely different. The other two just create a large container (either defined by
<markdown> tags or a .md file ending) and parse everything inside them as Markdown.
This plugin adds Markdown to the DokuWiki syntax, i.e. it still uses DokuWiki definitions for lists, headers, etc. Thus, markdowku enables you to use internal links, mix Markdown with other plugins and other syntaxes and have clean section headers and media embedding.
It would be nice if Commonmark would be supported!
Latest version is 2016-01-16, however the plugin repository is incorrectly showing 2017-02-19 as the current version, making the Extension Manager show an available update (that won't work since plugin.info.txt doesn't match the supposedly new version date).
I want to donate some bucks for the developer of the plugin. But donation didn't work.