DokuWiki

It's better when it's simple

User Tools

Site Tools


plugin:mdpage

Markdown Page Plugin

Compatible with DokuWiki

  • 2024-02-06 "Kaos" unknown
  • 2023-04-04 "Jack Jackrum" no
  • 2022-07-31 "Igor" unknown
  • 2020-07-29 "Hogfather" yes

plugin Show markdown block as a DokuWiki content

Last updated on
2021-01-09
Provides
Syntax
Repository
Source
Conflicts with
commonmark, markdownextra

This plugin is abandoned! New maintainers welcome.

Installation

Install the plugin using the Plugin Manager and the download URL above, which points to latest version of the plugin. Refer to Plugins on how to install plugins manually.

Examples/Usage

A simple block:

<markdown>
# Header

simple paragraph: *emph* **strong** `mono`.

> quote

[link](https://www.dokuwiki.org)
</markdown>

Configuration and Settings

name description
flavor Markdown Flavor
markdown_default You can use plain Markdown to write all pages without any special words by this option. :!: This is experimental feature and will change the specification.

Syntax

Basic syntax:

<markdown>some markdown text</markdown>

This plugin supports three flavors:

  1. GitHub Flavored Markdown: https://github.github.com/gfm/

This plugin supports internal links:

<markdown>
[internal link](:start)
[interwiki link](doku>plugin:mdpage)

![internal image](:wiki:dokuwiki-128.png)
</markdown>

Markdown Defaulting (Experimental)

If you enable markdown_default, you often use Markdown syntax without any tags. However, need a tag if you want to use DokuWiki syntax in Markdown as follows:

<!DOCTYPE markdown>

# Header

any Markdown contents: **Bold Text**, `Inline Code`

<script type="text/x-dokuwiki">
any DokuWiki content: **Bold Text**, <del>Strike-through Text</del>, ''Inline Code''
</script>

any Markdown contents: **Bold Text**, `Inline Code`

FAQ

  • Q: I cannot use inline HTML. Is this plugin supported HTML?
    • A: Yes. Please enable htmlok and then retry.
  • Q: I cannot use footnotes with Markdown Extra. Is this plugin supported Markdown Extra?
    • A: This plugin is not support full Markdown Extra flavor. See Issue #74.

Development

Change Log

Full releases: https://github.com/mizunashi-mana/dokuwiki-plugin-mdpage/releases

  • Release v2.2.0 (2021-01-09 08:47)
    Support links with titles: Fix #35
  • Release v2.1.0 (2020-12-20 09:53)
    More support markdown defaulting: Support #71
  • Release v2.0.0 (2020-09-13 19:33)
    Add Markdown defaulting switch (experimental feature). Support #66 Fix #64
  • Release v1.1.3 (2020-09-13 08:56)
    Update dependencies for Hogfather
  • Release v1.1.2 (2020-06-14 06:02)
    Include ctype polyfills. Fix #57

Known Issues and Wishes

When you find a bug or want any features and it is not appeared on this section, please make a new issue.

plugin/mdpage.txt · Last modified: 2023-05-26 19:03 by KaiMartin

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki