![]() Unfortunately in GitHub the result looks a bit odd, with that compressed empty header row: This adds HTML comment blocks in the header cells, which essentially adds an empty header row to the table. That StackOverflow post linked above shows a hack that seems to work in many Markdown parsers, including in GitHub: But apparently GitHub-flavoured Markdown and many other Markdown flavours don't support tables without headers. ![]() I could have written the README as a reStructuredText file, but I already created a README.md out of habit, so I tried to create the same table without header in Markdown. Now I wanted to do the same in Markdown in the corresponding GitHub repository with code examples. This looks fine as a simple table without a header. This is rendered by Nikola, the static site generator I'm using, as: ![]() | **Publisher** | Elektor International Media (EIM) | | **Title** | Control Your Home with Raspberry Pi | In reStructuredText, which I'm using for this website, the code for the table looks like this: When I wrote the page about my book Control Your Home with Raspberry Pi on this website, I wanted to list some specifications (title, publication date, number of pages. In general I prefer reStructuredText for longer and more complex documents, and Markdown for shorter and simpler texts. I use both markup formats for my projects on GitHub, depending on the complexity of the documentation. I write the posts on this blog in reStructuredText. I wrote my book in reStructuredText and converted it to a Word file with Sphinx to send to the publisher. I write most of my articles for print magazines in Markdown and convert them to office documents with a custom XSLT stylesheet and/or pandoc, depending on the magazine's requirements. Have you ever written a table without a header in Markdown? It turns out that most Markdown parsers don't support tables without headers.Īs a technology writer, I'm constantly switching between reStructuredText and Markdown as plaintext markup syntax (I write in Vim).
0 Comments
Leave a Reply. |
AuthorWrite something about yourself. No need to be fancy, just an overview. ArchivesCategories |