By Harrie Bickle | February 2, 2018
The future is here and it is written in markdown.
If you care more about content than code, and you understand that it is the words that count, then markdown is here for you.
In my opinion syntax is a pain. Some people are naturals and perfection flows from their fingertips. I am more the “need to be reminded to try for perfect” type. Fixing syntax errors feels like a constant nudge from someone whilst you are trying to concentrate on something more important.
A great example of the “excision of faffing around” that markdown excels at is probably this:
Do you want to create an external link? Then put it in your document:
and say farewell to all that fussing around with “, his perfectly-placed friend / and the
<a href="http://devil_in_the_detail.com">link to site here</a>
Want a header?
# H1 ## H2 ### H3
The “#” is all you need, you can use up to 6 of them.
Need an image?
(Sorry, you do still need to have / around for this one, some details really do matter).
image of dandelions
Tables can be built with pipes and formatted with colons:
| Tables | Are | Easy | | ------------------- |:-------------------: | ----: | | Right hand column | right-aligned | 10,000 | | Middle column | centered | 10 | | laces | are neat | 2 |
Now, whether or not that table appears as you expect depends upon what you are using to convert these .md files to HTML, and as that moves us out of newbie territory we’ll stop right there. This site itself is a great example of markdown in action. Hugo runs some Perl to render your files as HTML, letting you let the software worry about those fiddly details.
You write less syntax that is way more reader-friendly, and a bit of software converts your text into HTML following your gentle hints. What an excellent idea.