An Introduction to TiddlyWiki: A Wiki You Can Take Anywhere

6 December, 2021

This post was first published, in a different form, at and appears here via a CC-BY-SA 4.0 license.

When you think of the word wiki, chances are the first thing that comes to mind is Wikipedia. That’s not a surprise, considering that Wikipedia did help put the concept of the wiki into the popular consciousness.

Wikis, which are websites you can edit, are great tools for collaborating and organizing. But wikis usually require a lot of digital plumbing and a bit of care to use and maintain. All of that’s overkill for personal use.

Enter TiddlyWiki, the brainchild of British software developer Jeremy Ruston. TiddlyWiki is very easy to use and is very portable.

Let’s take a quick look at the basics of using TiddlyWiki.

What’s TiddlyWiki?

TiddlyWiki isn’t software quite as you know it. It’s a large web page (consisting of HTML and a lot of JavaScript) that weighs in at around 2.3 MB. You can edit and save the file in a web browser.

It’s very flexible. You can use TiddlyWiki to take notes, manage task lists, save bookmarks, publish a blog or website, create a presentation, create a digital garden, and a lot more. And people have used it to do some interesting things.

As I mentioned, TiddlyWiki is very portable. You can put it in a folder in, say, Nextcloud and share a TiddlyWiki between computers and mobile devices. Or, you can carry it around on a flash drive.

You can use an online service called Tiddyhost to host your TiddlyWiki on the web. If you’re of a more technical bent, you can set up a server and host it yourself.

Getting Started

Head over to the TiddlyWiki website and download the file empty.html. Rename that file to something a bit more meaningful and descriptive. Then open it in a web browser.

You’ll see the Getting Started tiddler (more about tiddlers in a moment):

Setting up TiddlyWiki

Change the information and then click the checkmark icon to save the TiddlyWiki.

A Note About Saving your TiddlyWiki

Since your web browser thinks a TiddlyWiki is a file, it’ll save your TiddlyWiki to the folder on your computer where downloads go. And when it does that, your browser will probably save it with a file name like tiddlywiki(1).html. You don’t want that.

If you’re using Chrome or Chromium, set the browser to ask you where to save files by selecting Settings, then clicking Show advanced settings on the Settings page. Then click the Ask where to save each file before downloading option.

If you’re using Firefox, click on the stacker menu in the top-right corner and select Options. Find the Downloads option, and click Always ask you where to save files.

There’s also an add-on for various browsers called Timimi that makes saving your TiddlyWiki easier.

Working with TiddlyWiki

You can use TiddlyWiki for just about anything. And people have done just that. But instead of jumping into the scary depths, let’s look at the basics of using TiddlyWiki.

Since I prefer to focus on specific tasks with my tools, I’m going to look at using TiddlyWiki for:

Taking Notes

To get going, create a new tiddler, which is an individual page within TiddlyWiki. I don’t know how many tiddlers a single TiddlyWiki can contain before it slows down, but I wouldn’t be surprised if it’s in the hundreds or thousands.

Create a new tiddler by clicking the + icon.

Creating a tiddler in TiddlyWiki

Give your tiddler a name, like Notes for netbooks essay. You can also type a tag in the Tag name field — doing that will let you filter your tiddlers so you can find them quickly when you have a lot of them. Then start typing.

You can format your tiddler using TiddlyWiki’s markup. You can also use the formatting toolbar to add character formatting, lists, quotes, headings, images, and links.

When you’re done, click the checkmark icon to save the tiddler.

Creating a Task List

Again, create a new tiddler. Give it a name like Tasks - 7 December 2021 and type Tasks in the Tag name field.

From there, type your tasks—one line for each. Put an asterisk (*) in front of each one to create a bullet list. Then save your list.

Creating a task list in TiddlyWiki

To mark off a completed task, edit the tiddler, highlight the task, and click the Strikethrough button on the toolbar.

That’s a pretty simple, and frankly lame, way to deal with tasks. If you’re looking for something more visually appealing, watch this video. This method requires a bit more setup, but you also get nifty checkboxes that you can click when you finish a task.

Keeping a Journal

If you want to keep a journal, first click the Tools tab and select the New journal option. That puts the Create a new journal tiddler button on the main TiddlyWiki toolbar.

Click that button and you’ll notice that the journal tiddler has today’s date as its name and has been tagged Journal.

As with any other tiddler, type your text and save the tiddler when you’re done.

The Power of Plugins

What if you want or need more from TiddlyWiki? You can use plugins to extend and customize TiddlyWiki’s capabilities. You can change its appearance, add editors and support for Markdown, turn TiddlyWiki into a personal kanban board, add a more powerful search engine, and more.

TiddlyWiki has a plugin library, which you can access from its control panel. There’s a list of plugins created by users.

One TiddlyWiki or Several?

You can load up your TiddlyWiki with everything you need to do. Eventually, though, it could get so full of tiddlers that it’s difficult to easily find what you need to find, even with good tagging.

An alternative to that is to have several TiddlyWiki files — for example, one for notes, one for tasks, one for outlines, one for journaling. Keeping track of those files could become a chore. The desktop version can help you better organize two or more TiddlyWiki files.

Learning More

I’ve only covered the basics of using TiddlyWiki. There is a lot you can do with it. Here are some good resources that can help you learn more about using TiddlyWiki:

Scott Nesbitt