By Deane Barker | September 2, 2004 | 8 Comments
Daring Fireball: Markdown Syntax Documentation: I’ve been playing around with some of the plugins in the MT3 Plugin Pack. Markdown is a plaintext to HTML convertor, much like Textile. However, there’s a philosphy behind it:
Readability, however, is emphasized above all else. A Markdown-formatted document should be publishable as-is, as plain text, without looking like it’s been marked up with tags or formatting instructions. […]
He’s really on to something here, because even unconverted, raw Markdown is really, really readable, due mainly to his removing URLs from the flow of the page. This seems like a small thing, but, in practice, it makes things SO much easier.
I really like the practice of the “reference” style URLs. For instance, this markdown…
[Gadgetopia][gdtc] is a good site.
…will link the words “Gadgetopia” to a URL specified anywhere else on the page, like this:
So you could set all your links up like footnotes at the end of the text, instead of jumbled up in the word flow. Very nicely done. I could actually see unleashing Markdown on users, whereas Textile was a geek-only affair.
What Links Here
[Note: After this comment was posted, I edited the entry and removed incorrect information. -- Deane]
“Or you can omit the second bracketed phrase completely”
Actually, you can’t omit the second bracket completely, However, you can leave it empty, like this:
[Gadgetopia] is a good site. ..and later on that page... [Gadgetopia]: http://www.gadgetopia.com/
Much discussion went on about this on the Markdown mailing-list earlier this summer, and it was decided (by John) that requiring the pair of empty bracket, was a tiny sacrifice in readability really worth accepting, because it removed a lot of ambiguity from the syntax.
This looks awesome, Deane. So when does GTDC start using it? =)
It’s already installed. Select it from the “Text Formatting” drop-down at the bottom of the editing screen.
It doesn’t work too well. When I entered
Happy Birthday Deane
I got the H3 tag when I looked at the preview, but it still had the hash marks in it on the front page.
See this comment:
There’s a PHP port:
Three-quarters of the attendees, who paid USD$ 35 each for the 20-minute event, were already experienced meditators. , http://www.sexinfo101.com, [url="http://vrvkbbh.pusades.co.cc/www.sexinfo101.com.html"]www.sexinfo101.com[/url], http://vrvkbbh.pusades.co.cc/www.sexinfo101.com.html http://www.sexinfo101.com, 0502,
This is especially useful in real-time computing applications where not stalling behind concurrent operations is critical. , thinktrank.4 teachers.org, [url="http://ol5.memoryteach.com/thinktrank.4-teachers.org.html"]thinktrank.4 teachers.org[/url], http://ol5.memoryteach.com/thinktrank.4-teachers.org.html thinktrank.4 teachers.org, :]],