Markdown
See also WYSIWYG and Markdown
Overview
Markdown has become a very popular type of common 'wikialike' Syntax used across the internet. Ever so often requests or project ideas are popping up in the Tiki dev-list to integrate Markdown to Tiki as an option besides WikiSyntax or WYSIWYG or to even replace the rock solid WikiSyntax. This is the developer page to conflate all ideas and thoughts and to provide a starting point for the person(s) who want to take on the project and to bring Markdown into the Tikiverse.
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
Limitations of Markdown compared to WikiSyntax
simple syntax examples
Copy to clipboard
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
Copy to clipboard
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
Related Wishes or Bugs
Open
Pending
Closed
Other related
- 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.
Related Pages
add related wikipages of dev.t.o and doc.t.o here
Alias
Markdown Integration
! {icon name="file-text" rotate="270"}~hs~Markdown
See also ((WYSIWYG and Markdown))
!! Overview
{DIV(class="lead")}Markdown has become a very popular type of common 'wikialike' Syntax used across the internet. Ever so often requests or project ideas are popping up in the Tiki dev-list to integrate Markdown to Tiki as an option besides WikiSyntax or WYSIWYG or to even replace the rock solid WikiSyntax. This is the developer page to conflate all ideas and thoughts and to provide a starting point for the person(s) who want to take on the project and to bring Markdown into the Tikiverse.{DIV}
The [https://spec.commonmark.org/|CommonMark spec], when printed, is over 100 pages! So it is very very elaborate.
{maketoc}
! (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
{CODE()}
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--
{CODE}
!!! combined syntax examples
{CODE()}
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 ...
{CODE}
!! 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 [https://commonmark.thephpleague.com/|CommonMark for PHP] lib. {sign user="luci" datetime="2019-05-24T15:07:52+00:00"}
!! Related
-=Related Wishes or Bugs=-
!!! Open
{LIST()} {filter field="tracker_id" exact="5"}
{filter field="title" content="Markdown"}
{filter field="tracker_status" content="o"}
{LIST}
!!! Pending
{LIST()} {filter field="tracker_id" exact="5"}
{filter field="title" content="Markdown"}
{filter field="tracker_status" content="p"}
{LIST}
!!! Closed
{LIST()} {filter field="tracker_id" exact="5"}
{filter field="title" content="Markdown"}
{filter field="tracker_status" content="c"}
{LIST}
-=Other related=-
* [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.
-=Related Pages=-
add related wikipages of dev.t.o and doc.t.o here
-=Alias=-
(alias(Markdown Integration))