In this column last week and the week before I discussed TiddlyWiki, a personal wiki system I think is one of the most compelling ideas I've seen for a long time.

Apparently great minds think alike because I received a letter before Christmas from longtime reader Brandon Sussman (Webster, N.H.), which I somehow missed in the whirl of the holidays. Sussman wrote recommending TiddlyWiki and said: "I think I found the killer app of killer apps … Words like ‘recursive PIM' and ‘one page wonder' are dancing in my head."

Exactly! This tool is that cool. Also, as I discussed last week, so is the amazing (and, remarkably, free) TiddlySpot service.

Now, I have had no major problems getting TiddlyWiki working, but of course, as with all software, YMMV (Your mileage May Vary).

Reader Gordon Andrews (Richmond, Va.) wrote: "I thought you'd found a new type of sliced bread until I went to a few sites and tried to learn what excited you. I downloaded. I set up pages at Tiddlyspot. I tried to find a good tutorial/getting started/beginners guide. I tried to learn. I even joined the discussion group at Google! Right now I think TW is something a sadist should recommend to masochists."

I had a telephone conversation Andrews and he's right. The documentation for TiddlyWiki is pretty weak, but that said, it is a free open source project and, as such, the developers have concentrated on getting it working instead of explaining it. And that's where I come in ….

So far we've discussed what TiddlyWiki is, the Tiddlyspot service, a few "flavors" of TiddlyWiki (original, MonkeyPirateTiddlyWiki, MonkeyGTD and d3 … there are many more), and some of its central concepts (single file implementation, portability, tiddlers, shadow tiddlers, editing). This week, we'll dive a little deeper.

Start by downloading (as I suggested in a previous column) a copy of the standard version of TiddlyWiki and experiment with that. I recommend this approach because TiddlyWiki, when hosted, has some subtleties and gotchas that are different from a locally hosted version of the system.

So, are you sitting comfortably? Then let us begin.

Tiddlers don't, by default, use HTML for formatting, they use something called TiddlyWiki Markup. Although this markup works perfectly well it is a horrible system for the simple reason that every tag has a different structure (see the TiddlyWiki Markup documentation) that is nothing like its HTML equivalent. Having to learn yet another markup language is just plain annoying.