<span style="font-family:courier new,monospace">Gentlefolk,</span><br style="font-family:courier new,monospace"><br style="font-family:courier new,monospace"><span style="font-family:courier new,monospace">I have been thinking on Markdown&#39;s lack of &quot;proper&quot; table support for a long while now.  Here&#39;s where I have arrived...</span><br style="font-family:courier new,monospace">

<br style="font-family:courier new,monospace"><br style="font-family:courier new,monospace"><span style="font-family:courier new,monospace">## I Don&#39;t Like HTML Tables</span><br style="font-family:courier new,monospace">

<br style="font-family:courier new,monospace"><span style="font-family:courier new,monospace">It is often argued that embedded HTML is the way to markdown rich tables.</span><br style="font-family:courier new,monospace">

<br style="font-family:courier new,monospace"><span style="font-family:courier new,monospace">Unfortunately, this contradicts the higher markdown ideal that a raw markdown document (including tables!) should be good</span><br>

<br style="font-family:courier new,monospace"><span style="font-family:courier new,monospace">1. Firstly for readers,</span><br style="font-family:courier new,monospace"><span style="font-family:courier new,monospace">2. Secondly for authors,</span><br style="font-family:courier new,monospace">

<span style="font-family:courier new,monospace">3. Lastly for parsers which don&#39;t even rate a mention because markdown is for Humans.</span><br style="font-family:courier new,monospace"><br style="font-family:courier new,monospace">

<span style="font-family:courier new,monospace">You have probably noticed already that HTML tables are *appalling* for readers and a nightmare for authors.  They are hardly &quot;good&quot; for markdown parsers either, which (not being HTML parsers) treat HTML tables as impenetrable blobs to be output &quot;as is&quot;.  Where does that leave us when we want to go from markdown to PDF?</span>  <br style="font-family:courier new,monospace">

<br style="font-family:courier new,monospace"><br style="font-family:courier new,monospace"><span style="font-family:courier new,monospace">## I Do Like Monospaced Tables</span><br style="font-family:courier new,monospace">

<br style="font-family:courier new,monospace"><span style="font-family:courier new,monospace">It is the _visual alignment_ of terms into rows and columns that enables a reader to recognise a table.  Without any recognisable alignment, a reader sees a jumbled &quot;cloud&quot; of terms -- which is exactly how we see tables with a variable width font.</span><br style="font-family:courier new,monospace">

<br style="font-family:courier new,monospace"><span style="font-family:courier new,monospace">Additionally, a raw markdown document should</span><br style="font-family:courier new,monospace"><span style="font-family:courier new,monospace"><br>

1. Be sharable, and,</span><br style="font-family:courier new,monospace"><span style="font-family:courier new,monospace">2. Convey the same information to every reader.</span><br style="font-family:courier new,monospace">

<br style="font-family:courier new,monospace"><span style="font-family:courier new,monospace">A raw markdown document must therefore be rendered *equivalently* for every reader.  This can only be assumed if every reader has the same text spacing, and a mono spaced is _a_ reasonable way of achieving this.</span><br style="font-family:courier new,monospace">

<br style="font-family:courier new,monospace"><br style="font-family:courier new,monospace"><br style="font-family:courier new,monospace"><span style="font-family:courier new,monospace">With all that in mind, I offer up my &quot;Teardown&quot; table specification for your consideration (</span><span style="font-family:courier new,monospace">I realise it will be &quot;torn down&quot;, but nothing ventured 
nothing gained).</span><br style="font-family:courier new,monospace">
<br style="font-family:courier new,monospace"><br style="font-family:courier new,monospace"><span style="font-family:courier new,monospace">Teardown offers the following over and above MultiMarkDown&#39;s table support:</span><br style="font-family:courier new,monospace">

<br style="font-family:courier new,monospace"><span style="font-family:courier new,monospace">* Multi-line cell content,</span><br style="font-family:courier new,monospace"><span style="font-family:courier new,monospace">* Additional &quot;Arty&quot; syntax for titles and footers (much nicer for authors and readers),</span><br style="font-family:courier new,monospace">

<span style="font-family:courier new,monospace">* Colspan (without meta-chars in cell content),</span><br style="font-family:courier new,monospace"><span style="font-family:courier new,monospace">* Rowspan,</span><br style="font-family:courier new,monospace">

<span style="font-family:courier new,monospace">* Cell alignment (without meta-characters in content)</span><br style="font-family:courier new,monospace"><br style="font-family:courier new,monospace"><br style="font-family:courier new,monospace">

<br style="font-family:courier new,monospace"><span style="font-family:courier new,monospace">*Please note* that I have _not_ implemented this specification.  This is all just hot air produced by an author trying contribute something toward better table support for markdown.</span><br>
<br>(specification to follow...)<br style="font-family:courier new,monospace">
<br style="font-family:courier new,monospace"><br style="font-family:courier new,monospace">