6 ms·

I was with him until he recommended one based on Wiki markup. Wiki markup is pretty universally reviled for good reasons. He right complained about the heavywe

by ebbv 14y ago

I was with him until he recommended one based on Wiki markup. Wiki markup is pretty universally reviled for good reasons. He right complained about the heavyweight notation required for a simple link in Markdown, but everything is that bad or worse in most Wiki markup. Really, the complexity of the markup you need depends on your application and any attempt to make a "one size fits all" markup is going to fail. The needs of a simple commenting system are vastly different from a user-editable CMS that doesn't want to give access to full HTML, but wants robust formatting options.

shaddyz 14y ago
I am really happy to see this article. I was just talking to a friend about how much I dislike Markdown and how it has become the de facto markup. Can you explain to me why wiki markup is universally reviled? I find Creole to be great text markup. It feels really natural to use and it expresses the intended meaning whether it's rendered using HTML or displayed in plain text. I really like this statement by Christoph Sauer on the Creole website: http://wikicreole.org/wiki/ChristophSauer http://wikicreole.org/wiki/ChristophSauer I agree that Creole or any other formatting markup is not going to solve everyone's problems. However, I think that whenever Markdown is a good choice, Creole is a better one.
- Tobu 14y ago
  That statement is nothing special, both Markdown and asciidoc claim to be a formalisation of the plain text conventions you already use. IMHO most of the alternatives mentioned in this comment thread understand their goals and the design space well enough, and many are definitive improvements over Creole's MediaWiki-inspired, committee-designed syntax. They also win in featurefulness (Markdown and Textile have html embedding, asciidoc and ReST have extension mechanisms), which is important for a wiki.
- vidarh 14y ago
  For me, the reason is that Creole (and formats like it), feels like markup. Writing Markdown feels like writing text. I was used to most of the conventions from Markdown mostly as-is from writing plain text for a couple of decades before I first saw Markdown. Whenever I come across Creole-style formats, I cringe - it means I need to think about the markup instead of think about just writing.
ryanackley 14y ago
Markdown is basically another flavor of wiki markup. It just happens to be the most popular iteration at the moment. I'm not sure how you can say wiki markup is universally reviled without lumping markdown into that statement. You must have a particular flavor of wiki markup in mind.
- Tobu 14y ago
  Wiki markup is recognisable with link conventions [[like this internal link]] and [[like this|http://external/link] http://external/link]] (MediaWiki and Creole; earlier wikis relied solely on CamlCase). Markdown's design is inspired by conventions used in plain-text email, with links [like this][1]. [1] http://site/ http://site/
  - elithrar 14y ago
    > Markdown's design is inspired by conventions used in plain-text email, with links [like this][1]. And [title](http://url.goes.here http://url.goes.here) for in-line URLs.
    - Tobu 14y ago
      Of course. Either way, it's close to the plain text convention, though one wouldn't bracket the link-name part.
  - tomjen3 14y ago
    That is not how I write plain-text email, and I don't think most people do either. I write links in plain-text emails as: www.example.com/awesome-video-of-kittens.jsp?referrer=whatever Note in particular that I don't put http in front, nor do I provide an alternative title.
    - icebraining 14y ago
      I don't get it, do you type the URLs by hand, or do you manually cut the http:// http:// from what the browser gives you? Both options seem odd to me.

by ebbv 14y ago

shaddyz 14y ago

I am really happy to see this article. I was just talking to a friend about how much I dislike Markdown and how it has become the de facto markup. Can you explain to me why wiki markup is universally reviled? I find Creole to be great text markup. It feels really natural to use and it expresses the intended meaning whether it's rendered using HTML or displayed in plain text. I really like this statement by Christoph Sauer on the Creole website: http://wikicreole.org/wiki/ChristophSauer http://wikicreole.org/wiki/ChristophSauer I agree that Creole or any other formatting markup is not going to solve everyone's problems. However, I think that whenever Markdown is a good choice, Creole is a better one.

Tobu 14y ago
That statement is nothing special, both Markdown and asciidoc claim to be a formalisation of the plain text conventions you already use. IMHO most of the alternatives mentioned in this comment thread understand their goals and the design space well enough, and many are definitive improvements over Creole's MediaWiki-inspired, committee-designed syntax. They also win in featurefulness (Markdown and Textile have html embedding, asciidoc and ReST have extension mechanisms), which is important for a wiki.
vidarh 14y ago
For me, the reason is that Creole (and formats like it), feels like markup. Writing Markdown feels like writing text. I was used to most of the conventions from Markdown mostly as-is from writing plain text for a couple of decades before I first saw Markdown. Whenever I come across Creole-style formats, I cringe - it means I need to think about the markup instead of think about just writing.

ryanackley 14y ago

Markdown is basically another flavor of wiki markup. It just happens to be the most popular iteration at the moment. I'm not sure how you can say wiki markup is universally reviled without lumping markdown into that statement. You must have a particular flavor of wiki markup in mind.

Tobu 14y ago
Wiki markup is recognisable with link conventions [[like this internal link]] and [[like this|http://external/link] http://external/link]] (MediaWiki and Creole; earlier wikis relied solely on CamlCase). Markdown's design is inspired by conventions used in plain-text email, with links [like this][1]. [1] http://site/ http://site/
- elithrar 14y ago
  > Markdown's design is inspired by conventions used in plain-text email, with links [like this][1]. And [title](http://url.goes.here http://url.goes.here) for in-line URLs.
  - Tobu 14y ago
    Of course. Either way, it's close to the plain text convention, though one wouldn't bracket the link-name part.
- tomjen3 14y ago
  That is not how I write plain-text email, and I don't think most people do either. I write links in plain-text emails as: www.example.com/awesome-video-of-kittens.jsp?referrer=whatever Note in particular that I don't put http in front, nor do I provide an alternative title.
  - icebraining 14y ago
    I don't get it, do you type the URLs by hand, or do you manually cut the http:// http:// from what the browser gives you? Both options seem odd to me.