# Blog style guide

Use this area to give a brief overview of the article you're writing. It'll show on the homepage as well as the top of the page.

## Greetings and salutations

You’ve happened upon our living style guide for the blog. The purpose here is to demonstrate various methods of using content in your articles. All articles are composed in ‘Markdown’, if you’re unfamiliar with this I’d suggest a bit of reading up, it’s quite simple once you get used to it. However if you’re more comfortable using HTML, feel free!

Second level headings are a great way to split up different sections of your content, don’t be afraid to take a little time to think about how your post will be laid out.

“This is my blockquote. There are many like it, but this one is mine. My blockquote is my best friend. It is my life. I must master it as I must master my life.”

Note: Markdown doesn’t have any dedicated citation syntax to the best of my knowledge so I’d recommend augmenting with HTML if you require one. As previously mentioned there’s no problem with mixing the two.

A nice thing to do is wrap some text around an image. Again spend sometime thinking about the layout of your page, images really help break up a sea of text and can add a lot.

Third level headings are useful if you need to break your content down one level further. Lists also help with breaking down content.

• This is an unordered list.
• These can be nested if required.
• Whilst easily switching back.

1. This is an ordered list which it great for things that need to be in a particular order. No surprise there.
2. Again these can be nested.
3. As evidenced here.

Sometimes though you want to make a bit more of the imagery, luckily there’s also the ability to add full width images inline. Remember not to overdo it with these though, they’ll take up a lot of screen space and bandwidth.

## Code highlighting

Code highlighting is supported across the blog, just reference the language you’re going to be using. Remember to add ‘linenos’ for line numbers. You can even do some inline highlighting if that tickles your fancy. Read more about it at the jekyll website. Also GH style code fences are supported, but the code fences will not have line numbers.

## Math

You can include LaTeX style math, but this requires setting a math: true header in your YAML frontmatter.

## Want more?

We’re constantly developing items you can add to a blog and it’s imperative we keep this page up to date with those items. If you’d like something in particular to be added please get in contact with Jakub or Ali.