| name | tiddlywiki-wikitext |
| description | Use when creating, editing, converting, or reviewing TiddlyWiki 5/TW5 tiddlers, TiddlyWiki WikiText, filters, widgets, transclusion, macros, procedures, tables, links, code blocks, or TiddlyWiki notes. Use official TiddlyWiki 5 syntax, not MediaWiki wikitext. |
| metadata | {"short-description":"Write accurate TiddlyWiki 5 WikiText"} |
TiddlyWiki WikiText
Scope
Use this skill for TiddlyWiki 5 WikiText only. Do not assume MediaWiki, GitHub Markdown, or other wiki syntaxes are valid in TiddlyWiki.
When exact syntax matters, consult official TiddlyWiki documentation before answering. Start with references/official-links.md, and prefer https://tiddlywiki.com/static/... pages as the source of truth.
Default to producing copy-pasteable tiddler body text unless the user asks for JSON, .tid fields, import/export format, or plugin/system tiddlers.
Common Patterns
- Internal link:
[[Tiddler Title]]
- Aliased internal link:
[[Displayed Link Title|Tiddler Title]]
- External URL:
https://tiddlywiki.com/
- Aliased external URL:
[[TW5|https://tiddlywiki.com/]]
- Forced/relative external link:
[ext[Label|./relative/path]]
- Transclude tiddler:
{{Tiddler Title}}
- Transclude field:
{{Tiddler Title!!field}}
- Transclude current tiddler field:
{{!!field}}
- Filtered transclusion:
{{{ [tag[Some Tag]] }}}
- Heading levels:
!, !!, !!!
- Bold:
''bold text''
- Italic:
//italic text//
- Underline:
__underlined text__
- Inline code:
`code`
- Code block: triple backticks at the start of a line, immediately followed by a line break.
- Table header cells: prefix cell text with
!, for example |!Name |!Value |
Output Rules
- Avoid Markdown-only conveniences unless TiddlyWiki supports them.
- Keep local file links explicit. Use a URL form such as
file:///Users/name/path/file.jsonl or [ext[Label|file:///Users/name/path/file.jsonl]] when the user wants a filesystem link.
- If using widgets, prefer clear widget syntax over clever shortcuts for dynamic behavior.
- For dynamic links, avoid trying to expand variables inside shortcut link syntax; use
<$link> with dynamic attributes instead.
- For notes intended for a personal wiki, include a compact title suggestion and tags only if useful.
Verification
Before presenting non-trivial WikiText, sanity-check:
- Is this TW5 syntax, not MediaWiki syntax?
- Are code blocks separated from preceding paragraphs by a blank line?
- Are local file paths represented as valid URLs when used as links?
- Do links with dynamic targets need widget syntax?
- Does the answer need an official-doc check before claiming a syntax detail?
