Square-bracket hell

16 February, 2007

There is little wiki syntax interoperability. In fact, it’s so bad that there are dedicated libraries for converting between almost every wiki system, the best probably being a Perl library called HTML::WikiConverter which also has an online demo and can covert HTML to sixteen different syntaxes. Sixteen!

There have been several efforts over the years to come up with a common syntax, and they’ve all petered out. The latest is called Creole and at their last workshop Ward Cunningham was on the Panel. In their own words:

Creole is a common wiki markup language to be used across different Wikis. It’s not replacing existing markup but instead enabling wiki users to transfer content seamlessly across wikis, and for novice users to contribute more easily.

They also have a reasonably impressive list of wiki engines with plugins for supporting this interchange syntax

You can see the wiki syntax they propose in the latest version of the spec (0.4 at the time of writing).

It’s not too bad so long as you can read words mixed between five vertical bars [[a bit|like this]] [[and|then]] [[maybe something|like this]]. It’s obviously to maintain the “all formatting is double-character” and to allow people to keep putting things in square brackets. Which of course they do all the time. Or, in the several thousand wiki pages I’ve seen, twice.

At least it doesn’t use MediaWiki’s markup for italics and bold. Visual clutter is crap.

See other posts tagged with usability wiki wiki and all posts made in February 2007.


16 February, 2007 at 20:03

Oh, ””’Come On!””’, media wiki has ”the best” ”’syntax”’ ””’Ever””’!.

16 February, 2007 at 20:54

Why do we even have the Wiki syntax? I always wondered about that.

Some of the more complex syntax rules I have seen at various Wiki’s are almost as difficult to remember for un-initiated users as HTML tags.

They also create a similar amount of visual clutter as standard HTML. So why not stick to a stripped down HTML subset for all the formating rules?

Or even better – use xml for all formating, and then apply formating via css.

Mathew Peet
17 February, 2007 at 09:45

No WYSIWYG wikis yet?