Yet another markdown cheat sheet

Using markdown to create and publish beautiful content quickly

Christopher Davies
Nov 30, 2018 · 4 min read

What is markdown?

Markdown is a lightweight markup language that can be easily converted to more readable formats like HTML. In this tutorial, we’ll look at how to create beautiful content quickly and cleanly using markdown syntax in Notably

What is Notably?

Notably is a notes app that supports markdown syntax and aims to minimise distractions and provide as clean an interface as possible. Notably also allows you to share your posts publicly with SEO friendly URLs — you could even implement your own blog using Markdown and Notably alone. Notably is completely free of charge

Markdown syntax

Headers

You can log into to Notably using your Google account. Once you’ve done that, let’s dive in and get started straight away — let’s create a new note and give it a title. You can create a header by simply prepending # to the start of the line, or by adding “===” to the following line:

Option 1
# Markdown is great

Both options product the same result

In total, markdown supports 6 levels of header (e.g. h1-h6)

# Header 1   
## Header 2   
### Header 3   
#### Header 4   
##### Header 5   
###### Header 6

Text highlighting

You can use markdown to mark text as bold, italic or strikethrough, or any combination of the three:

Here is some **bold** text
Here is some *italic* text
Here is some ~~strikethrough~~ text
~~***This text is a combination of all three***~~

To add additional emphasis to a line of text, you may also want to create a block quote, which you can do by adding a chevron to the start of a line

> This is a blockquote

Links

Any URLs you enter into markdown automatically get converted into links

https://notably.cc

Alternatively, you can replace the link text with a label of your choosing using this syntax:

[Notably](https://notably.cc)

Lists

It’s very easy to create ordered or unordered lists with Markdown:

Unordered list
- item 1
- item 2
- item 3

Images

If you have an image URL, you can insert it with markdown very easily, and even provide alt text

![Some random image](https://picsum.photos/200/200/?random)

Code blocks

Code blocks in markdown can be added in the exact same way as in Medium — by enclosing text between sets of three back ticks

```
This is a code block

Produces:

This is a code block

Horizontal rules

Finally, you can also divide your content into segments using horizontal rules — you can create these with underscores, asterisks or hyphens

---
***
___

Sharing your content

Notably allows you to share your content publicly by using the share button next to each post

This produces an SEO friendly URL at which people can access your content. I’ve even recreated this blog post in Notably so you can see a practical example

Christopher Davies

Written by

Full stack Django developer and creator of https://www.packagr.app