Loading...
 

Tiki-Flavored Markdown


New in Tiki25 is an option to use Tiki Flavored Markdown, which is essentially GitHub Flavored Markdown (GFM) with additional syntax, which itself is essentially CommonMark with additional syntax, which itself is a standardized Markdown.

GFM is a strict superset of CommonMark.

CommonMark is a "A strongly defined, highly compatible specification of Markdown": https://commonmark.org/

Over the last few years, it has become the de facto standard for textual syntax on the web.

Why did Tiki move to this?

Tiki has always supported Open Standards. If such a standard had existed when Tiki started, we would have used it.

History

When Tiki started in 2002, there was no standard for textual syntaxes. So the Tiki community, like other wiki engines just invented a syntax. No grand design. Just grew organically.

In 2006, wiki engines got together to elaborate a standard:


And Tiki was on board with moving to a standard:


Some believed that WYSIWYG editors would make this need go away. We didn't see how that was possible:


Unfortunately, Wiki Creole didn't gather significant adoption. Why? Likely many reasons, but one is: MediaWiki (huge market share with Wikipedia and many other projects) didn't adopt it.

Be it Wiki Creole or something else, it seemed inevitable that a wiki/textual syntax would eventually become a de facto standard. But which one?


Over time, Markdown popularity grew, and the CommonMark project made it easy to adopt for developers.

Also, a new crop of Markdown WYSIWYG editors appeared, and matured. Either

  • Open Source or proprietary
  • Web-based, mobile or desktop apps.


In 2019, Tiki20 added the possibility to add CommonMark to a section of a page: PluginMarkdown.

In 2022, Tiki25 added the possibility to add Tiki Flavored Markdown by default to all content, and use the TOAST UI Editor.

The Future

Next steps:

  • Tiki Flavored Markdown will become the default syntax at one point.


What will happen to Tiki syntax?

For the foreseeable future, it will remain an option in Tiki

  • The code is stable so we don't need to invest time on it.
  • 2 decades of Tiki users have content using it. Migration is just too much work.


However, development and innovation will shift to Tiki Flavored Markdown so over time, there will be more and more incentive to migrate.

In 2023, we will see a lot of work on migration as Tiki instances big and small upgrade to Tiki25 and Tiki26.

FAQ

Is it possible to use Tiki Flavored Markdown for new content, while old content remains in Tiki syntax.

Yes, this is the default behavior.

What parser does Tiki use?

league/commonmark which has over 130 million downloads.

Why didn't Tiki move to something else sooner?

Changing wiki syntax is one of the most disruptive things you can do to a wiki engine. It affects all the content. And it affects all the users. Thus, it is a huge quantity of work, and has the risk of alienating members of the community (they feel it imposes work on them, and they don't see the benefits).

The recent availability of WYSIWYG editors for Markdown increased the impetus to move forward.

Also, it's acceptable to do a change like this every 10 or 15 years. So you need to be confident in your decision. And while CommonMark has become the de facto standard, the spec has still not reached 1.0.

What does Tiki offer that goes beyond the Markdown standard?

alias

Markdown

doc.tiki.org

Get Started

Admin Guide User Guide

Keywords

Keywords serve as "hubs" for navigation within the Tiki documentation. They correspond to development keywords (bug reports and feature requests):

Accessibility (WAI and 508)
Accounting
Articles and Submissions
Backlinks
Banners
Batch
BigBlueButton audio/video/chat/screensharing
Blog
Bookmark
Browser Compatibility
Link Cache
Calendar
Category
Chat
Clean URLs
Comments
Communication Center
Compression (gzip)
Contacts (Address Book)
Contact us
Content Templates
Contribution
Cookie
Copyright
Credit
Custom Home and Group Home Page
Date and Time
Debugger Console
Directory of hyperlinks
Documentation link from Tiki to doc.tiki.org (Help System)
Docs
Draw
Dynamic Content
Dynamic Variable
External Authentication
FAQ
Featured links
File Gallery
Forum
Friendship Network (Community)
Gmap Google maps
Groups
Hotword
HTML Page
i18n (Multilingual, l10n)
Image Gallery
Import-Export
Install
Integrator
Interoperability
Inter-User Messages
InterTiki
Kaltura video management
Karma
Live Support
Login
Logs (system & action)
Look and Feel
Mail-in
Map with Mapserver
Menu
Meta Elements
Mobile Tiki and Voice Tiki
Module
MultiTiki
MyTiki
Newsletter
Notepad
Payment
Performance Speed / Load
Permissions
Platform independence (Linux-Apache, Windows/IIS, Mac, BSD)
Polls
Profiles
Profile Manager
Report
Toolbar
Quiz
Rating
Feeds
Score
Search engine optimization
Search
Search and Replace
Security
Semantic links
Shadowbox
Shadow Layers
Share
Shopping cart
Shoutbox
Slideshow
Smiley
Social Networks
Spam protection (Anti-bot CATPCHA)
Spellcheck
Spreadsheet
Stats
Surveys
Tags
Task
Tell a Friend, alert + Social Bookmarking
TikiTests
Theme CSS & Smarty
Tiki Manager
Trackers
Transitions
User Administration including registration and banning
User Files
User Menu
Watch
WebDAV
Webmail
Web Services
Wiki History, page rename, etc
Wiki Syntax
Wiki structure (book and table of content)
Workspace
WSOD
WYSIWYCA
WYSIWYG
XMLRPC

Tiki Newsletter

Delivered fresh to your email inbox!
Newsletter subscribe icon
Don't miss major announcements and other news!
Contribute to Tiki