Markdown
Sep 2

Markdown

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.

Here, read this. This is some markdown text for one of the pages on his site. You can read it really well, can’t you? And this is raw — the post-Markdown version is here.

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:


[gdtc]: http://www.gadgetopia.com/

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.

by Deane   September 2, 2004 5:12 PM    |   Follow Gadgetopia on Twitter

Comments

Már Örlygsson Már Örlygsson
by Már Örlygsson,   September 3, 2004 3:56 AM  

[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]: <a href="http://www.gadgetopia.com/">http://www.gadgetopia.com/</a>

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.

Joe Joe
by Joe,   September 3, 2004 8:44 AM  

This looks awesome, Deane. So when does GTDC start using it? =)

Deane Deane
by Deane,   September 3, 2004 8:56 AM  

It's already installed. Select it from the "Text Formatting" drop-down at the bottom of the editing screen.

Joe Joe
by Joe,   September 3, 2004 9:31 AM  

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.

Deane Deane
by Deane,   September 3, 2004 1:12 PM  

See this comment:

http://www.gadgetopia.com/2004/08/31/MT31UpgradeReport.html#CommentID_4104

Deane Deane
by Deane,   September 3, 2004 1:13 PM  

There's a PHP port:

http://www.michelf.com/projects/php-markdown/

Uhatmftt Uhatmftt
by Uhatmftt,   November 12, 2010 3:40 PM  

Three-quarters of the attendees, who paid USD$ 35 each for the 20-minute event, were already experienced meditators. , 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 www.sexinfo101.com, 0502,

Bjwrlami Bjwrlami
by Bjwrlami,   November 27, 2010 8:56 PM  

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, :]],

Add Comment