Markdown

See also WYSIWYG and Markdown

Overview

The CommonMark spec, when printed, is over 100 pages! So it is very very elaborate.

(potentially) interested or needed people

Gour, Luci, Jonny, Brendan, Torsten, (add yourself) ...

Concepts of integrating Markdown to Tiki

PluginMarkdown

See PluginMarkdown.

CKE with Markdown capability

Replacing WikiSyntax with Markdown

See also below "Limitations of Markdown compared to WikiSyntax"

Ideas & Thoughts

please add your ideas and thoughts

Libraries and Varieties

• https://packagist.org/search/?tags=markdown
• https://commonmark.org

Limitations of Markdown compared to WikiSyntax

simple syntax examples

italic
Markdown: *italic* or _italic_
WikiSyntax: ''italic''

bold
Markdown: **bold** or __bold__
WikiSyntax: __bold__

underlined
Markdown: ???
WikiSyntax: ===underlined===

strike through
Markdown: ???
Markdown (Pandoc, GFM): ~~strikethrough~~
WikiSyntax: --strikethrough--

combined syntax examples

italic + bold
Markdown: _**italic bold**_
WikiSyntax: ''__italic bold__'' or __''bold italic''__

underline + strike through + italic + bold
Markdown: ???
WikiSyntax: ===--''__underline strikethrough italic bold__''--== or __''--===bold italic strikethrough underline===--''__ or ...

Markdown and WikiPlugins

WikiPlugins can be used all over Tiki as extended part of the WikiSyntax and inside the WYSIWYG ... this has to be possible with Markdown as well, respectively the potential Tiki Markdown parser has to parse WikiPlugins!

First implementation done by luci for Tiki20 as PluginMarkdown by using the CommonMark for PHP lib.

Related

Open

• Markdown in Tiki 27 depends on external source for the WYSIWYG markdown editor
• syntax type=markdown code disappears from Content Template
• Converting page from Wiki Syntax to Markdown (issues and workarounds)
• In Tiki 27, using Markdown and a wiki plugin, some wiki page content is duplicated when the page edit screen is opened again
• ability to reference images by using wiki/markdown markup
• In the Settings -> textarea, the markdown option is visible after you check the Advanced pref filter but no options
• Creating a category when Markdown is enabled causes an issue in the category title
• Missing cheat sheet or extanded help on the Markdown toolbar's help

  
  

Pending

• markdown rendering issues
• Converting pages from Wiki syntax (tiki) to Markdown syntax - Workaround

  
  

Closed

• WIP: Wiki Syntax, Markdown; Wiki links are not parsed (when markdown is enable)
• Wiki page, Markdown: Carriage return are not displayed
• Plugin Fancytable content not parsed when using Markdown
• Markdown support
• Markdown plugin does not parse quoted text properly
• PluginQuote "eats" text when used along with Markdown plugin

  
  

• item6697-Markdown-support
• https://tools.ietf.org/html/rfc7763
• https://github.com/euangoddard/clipboard2markdown
• https://github.com/jgm/djot Djot is a light markup syntax. It derives most of its features from commonmark, but it fixes a few things that make commonmark's syntax complex and difficult to parse efficiently. It is also much fuller-featured than commonmark, with support for definition lists, footnotes, tables, several new kinds of inline formatting (insert, delete, highlight, superscript, subscript), math, smart punctuation, attributes that can be applied to any element, and generic containers for block-level, inline-level, and raw content.

add related wikipages of dev.t.o and doc.t.o here

Markdown Integration