Hacker News new | ask | show | jobs
by drhayes9 3249 days ago
Most of Markdown is great for me and feels natural. Headings, bold, italics, lists -- those are all great.

Examples that don't feel natural are image syntax, dropping down to HTML for unsupported features (pre-supposes output format), emphasis on presentation vs. semantics, the various flavors of writing tables, etc. How do I write an index? A table of contents? Any way to differentiate a footnote or an aside from a basic link?

YAML front matter is a great ad hoc standard for including metadata about a document within the document. It would be great if the various flavors of Markdown standardized on that, too.