First draft of full syntax docs

John Gruber gruber at fedora.net
Fri Mar 12 23:29:16 EST 2004


Aaron Swartz <me at aaronsw.com> wrote on 03/12/04 at 2:28p:

> > What if I add a another page: "Intro" or "Getting Started" or "Quick
> > Ref" or something? I.e., instead of:
> 
> I still think people would click it and get scared, but it would be an 
> improvement.

SmartyPants only has one web page, and it's pretty darn long, and it
doesn't seem to have scared people away.

It's not the length of the syntax page that might scare people away.
It's the fact that as it stands now, it's hard to get a general
sense of what Markdown's syntax is like. The cheatsheet alongside
the dingus helps, but it'd be better with a slightly expanded
version on its own page, which could contain much longer examples.

-J.G.


More information about the Markdown-discuss mailing list