tid2md.py: Convert WikiText tiddlers (.tid) to Markdown tiddlers (.md)

48 views
Skip to first unread message

MaxGyver

unread,
Sep 24, 2022, 2:28:51 PM9/24/22
to TiddlyWiki
Hi TiddlyWiki users,

I would like to share my Python script that I use to convert WikiText tiddlers (.tid) to Markdown tiddlers (.md):


Markdown has the advantage that it's used in many places (p.e. GitHub, GitLab, BitBucket, StackOverflow, Reddit) and is supported by many editors, parsers and other tools. When you often copy tiddlers (or parts of them) to other websites or when you edit/process your .tid files with tools except TiddlyWiki itself, it might make sense to write your tiddlers in Markdown or migrate those already written in WikiText to Markdown.

I also use this script to create a static version of my wiki directly (meaning not using TiddlyWiki) from the .tid files. Of course, there is a second step necessary to convert the resulting .md files to HTML. But it's much faster than using `tiddlywiki /path/to/wiki --render '$:/core/templates/alltiddlers.template.html' /tmp/static_wiki.html text/plain` and the resulting HTML file is much simpler.

If you are interested, just try it (on a copy of your wiki) and create an issue if something does not work as expected.

Best regards,
Max
Reply all
Reply to author
Forward
0 new messages