MarkDown Newbie

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> gang.

<a href="">link to site here</a>

Want a header?

No <h1>wrapper</h1>needed:

# 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).

![imageDescription]( imageLegend

image of dandelions 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.


Cheat Sheet

Hugo Help

Interactive Tutorial

Go deeper

About us

Photobox Group is Europe’s leading digital consumer service for personalised products and gifts and parent of the Photobox, Moonpig, Hofmann and posterXXL brands.

Creative Commons License

© 2018, Photobox Group Security. This work is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.


Photobox Group Security
Unit 7, Metal Box Factory
30 Great Guildford Street