A little bit about myself. I work as a software architect/lead developer for a large telecommunication company in Canada (my opinions expressed on this Web site are my own). I also have a broad experience with software usability.
I've been a very heavy user of wikis for the last 7 years mainly for internal projects - my team writes all of our software development documents in wikis (FlexWiki, MediaWiki, TWiki, TikiWiki, TRAC, XWiki, etc.). I'm also working really hard to install and implement wikis in my clients' organizations especially in their software development environments.
One of my goal is that humans use only one type of markups to write text quickly and efficiently for blogs, wikis, newsgroups, emails, readme files, ... The SGML family is great for structured or semi structured documents/data but it sucks when you have to write plain old text files with formatting by hand.
So, to give back to the community, I want to contribute a little to this wonderful effort.
If you want to contact me personally, you can write me at echartre at gmail dot com
What I like about Creole is that it could be the One Ring to Rule Them All (just kidding)! Seriously, with the broad support from wiki developers, it could be this spec that makes the unification possible in the long run. If we could get OLPC involved (CrossMark), it would be another great asset.
IMHO, the specification should not include any rendering i.e. (X)HTML suggestions. It should express the meaning of the markup accompanied by a very precise syntax.
My general position is to keep the standard as simple but as rich as possible for the user, two goals that are somewhat opposite, while minimizing the effect on existing WikiMLs. It should allow for a variety of writing styles so it can be accepted quickly.
I will express my opinion about NotNew in the next couple of days...
So, after reading all of the discussions and proposals, this is what I think:
| Element | Markup |
|---|---|
| Emphasis | **text** //text// __text__ |
| Superscript | ^^superscript^^ |
| Subscript | ,,subscript,, |
| Inline preformatted | {{{text}}} |
| Inline quoting | :::text::: or """text""" |
| No wiki (escape) | \character |
| Element | Markup |
|---|---|
| Headings | = Level 1 = or !Level 1 == Level 2 == or !!Level 2 === Level 3 === or !!!Level 3 ==== Level 4 ==== or !!!!Level 4 ===== Level 5 ==== or !!!!!Level 5 |
| Ordered Headings | =# Level 1 = or !#Level 1 ==# Level 2 == or !!#Level 2 ===# Level 3 === or !!!#Level 1 ====# Level 4 ==== or !!!!#Level 4 =====# Level 5 ==== or !!!!!#Level 5 |
| Unordered Lists | * Item 1 or - Item 1 ** Item 2 or -- Item 2 ... (4 levels max.) |
| Ordered Lists | # Item 1 ## Item 2 #^ Continue numbering level 1 ##^ Continue numbering level 2 ... (4 levels max) |
| Line breaks | \ at the end of a line (with or without subsequent spaces) |
| Paragraph breaks | Two new lines or \\\ |
| Centered line | >> Text |
| Element | Markup |
|---|---|
| Quoting | """ Quote """ or ::: Quote ::: Markup must be by itself on a line (with or without spaces) |
| Preformatted | {{{ }}}\\ {{{Preformatted}}} \\ {{{ }}} Markup must be by itself on a line (with or without spaces |
| Element | Markup |
|---|---|
| Tables heading | |= Row/column heading |
| Table cell | |Cell |
| Cell span | TBD |
| Element | Markup |
|---|---|
| Images | {{my image}} Images can be used instead of a description in a link |
| Links | [[Description|Link]] The Link part is optional |
| Horizontal lines | ---- Any number of - equal or greater than 4 |
| Element | Markup |
|---|---|
| Placeholder | << Placeholder >> |
| Element quality | TBD |