title: TiddlerFiles
modifier: JeremyRuston
Tiddlers can be stored in text files in several different formats. Files containing single tiddlers can also have an auxiliary {{{.meta}}} file formatted as a sequence of name:value pairs:
{{{
title: TheTitle
modifier: someone
}}}
!! ~TiddlyWeb-style .tid files
These files consist of a sequence of lines containing name:value pairs, a blank line and then the text of the tiddler. For example:
{{{
title: MyTiddler
modifier: Jeremy
This is the text of my tiddler.
}}}
!! TiddlyWiki {{{
}}} .tiddler files
Modern {{{*.tiddler}}} files look like this:
{{{
Note that there is an embedded tag, and line feeds are not escaped.
And, weirdly, there is no HTML encoding of the body.
}}}
These {{{*.tiddler}}} files are therefore not quite the same as the tiddlers found inside a TiddlyWiki HTML file, where the body is HTML encoded in the expected way.
Older {{{*.tiddler}}} files more closely matched the store format used by TiddlyWiki at the time:
{{{
This is an old-school .tiddler file, without an embedded <pre> tag.\nNote how the body is "HTML encoded" and new lines are escaped to \\n
}}}
!! ~TiddlyWeb-style JSON files
These files are a straightforward array of hashmaps of name:value fields. Currently only these known fields are processed: {{{title}}}, {{{text}}}, {{{created}}}, {{{creator}}}, {{{modified}}}, {{{modifier}}}, {{{type}}} and {{{tags}}}.
!! TiddlyWiki HTML files
TiddlyWiki HTML files contain a collection of tiddlers encoded in {{{
}}} format.