First draft of full syntax docs

Aaron Swartz me at aaronsw.com
Fri Mar 12 12:46:11 EST 2004


The syntax page is quite long. I'm concerned that people interested in 
Markdown will click syntax to see how it works, and upon seeing such a 
long page, be scared off. ("What have I gotten myself into? I don't 
have time to read this whole thing!")

The syntax page is excellent; I wouldn't get rid of it. But I think you 
might be better off putting a version of the cheatsheet on the Syntax 
page with a link to the full detailed guide. And maybe a note on the 
full guide that you don't need to read it to use Markdown -- the syntax 
is simple and intuitive for the most part.

-- 
Aaron Swartz: http://www.aaronsw.com/



More information about the Markdown-discuss mailing list