Loading...
 
Skip to main content

History: Markdown Syntax

Source of version: 7 (current)

Copy to clipboard
            ! Markdown Syntax
[https://tiki.org|Tiki Wiki CMS Groupware] provide different, rich and flexible systems for formatting and presenting pages. The ((Wiki Syntax)), the Markdown Syntax (this page), the ((WYSIWYG|Full WYSIWYG editor)). This page describes how to format text, using markdown syntax, on wiki pages and other area  (including articles, forums, and blogs).

!! About markdown syntax
Markdown's syntax is intended to be used as a format for fast writing for the web. Its syntax is very small, corresponding only to a very small subset of HTML tags. The idea is to create a syntax that makes it easier to add or edit content. It is quite popular among content creators.

!! About the markdown syntax in Tiki
In discussion and partially added in ((Tiki20)) it was fully integrated in ((Tiki25)) (still experimental in Tiki25) with the addition of an option to use ((Tiki-Flavored Markdown)) and option to select which syntax you want to use. Tiki site that used previously the Wiki Syntax can be converted to use the Markdown Syntax, see: ((Converting from Tiki syntax to Markdown))

Like the Wiki syntax, the Markdown syntax uses a character repeated twice for most functions, but it also has a few two-character combinations.

!!! How to enable Markdown in Tiki
By default Tiki uses the ((Wiki Syntax)). To enable the Markdown Syntax, log as admin go to Settings => Control Panels => Main Features => Editing and Plugins (/tiki-admin.php?page=textarea).
On the General Settings tab, navigate to the Markdown section.

!!! Quick reference - basic text formatting
''To come when this site will use markdown''
Please refer to this guide: https://www.markdownguide.org/basic-syntax/

!!! Best practices
Markdown applications don’t agree on how to handle a missing space between the number signs (#) and the heading name. For compatibility, always put a space between the number signs and the heading name.
Do this : # Here's a Heading
Don't do this: #Here's a Heading

Don't put tabs or spaces in front of your paragraphs.

!!!! Examples
!!!! Headings
Use a single or a succession of this character to set the heading level "#"
# Heading level 1	<h1>Heading level 1</h1>	
Heading level 1
## Heading level 2	<h2>Heading level 2</h2>
etc...	
Heading level 2

!!!! Line Break
Line Breaks
To create a line break or new line (<br>), end a line with two or more spaces, and then type return.

!!!! Bold text
To bold text, add two asterisks "*" or underscores "_" before and after a word or phrase. To bold the middle of a word for emphasis, add two asterisks without spaces around the letters.

I just love **bold text**.
I just love __bold text__.

!!! Italic text
To italicize text, add one asterisk or underscore before and after a word or phrase. To italicize the middle of a word for emphasis, add one asterisk without spaces around the letters.

Italicized text is the *cat's meow*.
Italicized text is the _cat's meow_.

!! Related pages
((Converting from Tiki syntax to Markdown))
((PluginMarkdown))
((Tiki-Flavored Markdown))

!! Useful Links
* https://www.markdownguide.org/basic-syntax/