====== Markdown Page Plugin ======

---- plugin ----
description: Show markdown block as a DokuWiki content
author     : mizunashi_mana
email      : axnnoindexr11@gmail.com
type       : Syntax
lastupdate : 2021-01-09
compatible : Hogfather, Greebo, !Jack Jackrum
depends    : 
conflicts  : markdownextra
similar    : markdowku, markdownextra
tags       : markdown, markup_language, formatting

downloadurl: https://github.com/mizunashi-mana/dokuwiki-plugin-mdpage/raw/release/plugin-package.tar.gz
bugtracker : https://github.com/mizunashi-mana/dokuwiki-plugin-mdpage/issues
sourcerepo : https://github.com/mizunashi-mana/dokuwiki-plugin-mdpage/
donationurl: 

screenshot_img : https://raw.githubusercontent.com/mizunashi-mana/dokuwiki-plugin-mdpage/master/assets/screenshot.png
----

**This plugin is abandoned! New maintainers welcome.**

===== Installation =====

Install the plugin using the [[plugin:plugin|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:
<code><markdown>some markdown text</markdown></code>

This plugin supports three flavors:

  - GitHub Flavored Markdown: https://github.github.com/gfm/
  - Markdown Extra: https://michelf.ca/projects/php-markdown/extra/
  - Traditional Markdown: https://daringfireball.net/projects/markdown/syntax

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:

<code>
<!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`
</code>

===== FAQ =====

  * **Q:** I cannot use inline HTML. Is this plugin supported HTML?
    * **A:** Yes.  Please enable [[config: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 [[https://github.com/mizunashi-mana/dokuwiki-plugin-mdpage/issues/74|Issue #74]].

===== Development =====

See [[https://github.com/mizunashi-mana/dokuwiki-plugin-mdpage#readme|README on GitHub]]

=== Change Log ===

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

{{rss>https://github.com/mizunashi-mana/dokuwiki-plugin-mdpage/releases.atom 5 description date}}

=== Known Issues and Wishes ===

When you find a bug or want any features and it is not appeared on this section, please [[https://github.com/mizunashi-mana/dokuwiki-plugin-mdpage/issues/new|make a new issue]].

{{rss>https://rsshub.app/github/issue/mizunashi-mana/dokuwiki-plugin-mdpage description}}