This page is part of a static HTML representation of the TiddlyWiki at https://tiddlywiki.com/

Block Mode WikiText

 12th May 2024 at 12:15am

Some WikiText is recognised only while the parser is in block mode.

Common characteristics of such block mode WikiText:

  • At least one entire line is required to delimit the WikiText.
  • The closing punctuation must come at the end of the line (in some cases the end of the line is the closing punctuation.
WikiTextPunctuation
Block Quotes in WikiTextMulti-line block quotes are enclosed by lines containing only the text <<<; single line block quotes are also possible.
Code Blocks in WikiTextEnclosed by lines containing only the text ```
Definitions in WikiTextEach term is on its own line and each definition is on its own line.
Hard Linebreaks in WikiTextEnclosed by lines containing only the text """.
Headings in WikiTextEntire line starting with !.
Horizontal Rules in WikiTextA line containing only the text ---.
Lists in WikiTextEach list item is on its own line.
Paragraphs in WikiTextAny text other than the start punctuation of one of the other block mode WikiText will start a paragraph. Even the start punctuation of inline mode WikiText will start a paragraph. The parser includes all following lines into the paragraph until it encounters a blank line.
Styles and Classes in WikiTextEnclosed by lines starting with @@.
Tables in WikiTextEach table row is a line starting and ending with |.
Typed Blocks in WikiTextEnclosed by lines starting with $$.

The above WikiText types are only recognised in block mode. However, the text enclosed by most of them will be parsed in inline mode (Block Quotes in WikiText and Styles and Classes in WikiText are the two exceptions in which the parser will continue in block mode). While in inline mode the parser may encounter something which moves it to block mode (see WikiText parser mode transitions).

At the end of the terminating line, the parser will return to block mode.

Tip
Note: Hard Linebreaks in WikiText require an extra blank line after the trailing """ before the parser will return to block mode.

If the punctuation for the above types of WikiText is encountered while the parser is in inline mode, it will be ignored and output as-is.

Examples