Your handheld guide to Markdown

26 January 2023

Markdown is a markup language used to create documents. It is easy to use, which makes it a very effective tool. When writing in Markdown, your text will be automatically formatted, such as headings, bold or italic text, among others.

It is a very versatile markup language, as it can be used to create a variety of documents, such as PDFs, websites, books, presentations, notes, emails and documentation. One of the great advantages of Markdown is that documents created with this language are easy to read on any system, since no special program is needed to open them (like word), which makes it very useful and powerful.

This makes Markdown an important tool to know and use due to its great versatility. Therefore it is necessary to understand how it works in order to get the most out of it.

Let’s get started!

The first thing we need to know to get started is that Markdown uses the .md extension to create documents.

Now that we know the basics, we can start explaining how to use it.

Headers

Markdown uses the operator ( # ) to define a header. But this does not stop here and the concatenacion of this operator allows us to adjust the size of this, there are six types of sizes being the first size ( 1 ) the largest and the sixth ( 6 ) the smallest, commonly we will see these named as h< size > ( “h” refers to “header” ). Link to example

# I am an h1 header
## I am an h2 header
### I am an h3 header
#### I am an h4 header
##### I am an h5 header
###### I am an h6 header

Paragraphs, text decorators and separators

Paragraphs

In Markdown to write paragraphs we don’t have to use any operator, and to separate between paragraphs we only have to leave a blank space between them. Link to example

I am a paragraph!

I am another paragraph!

Decorators

In Markdown we can strike out using the ( ~ ) operator twice on both sides of the text, italicize our text using the ( * ) operator once on both sides of the text, bold our text using the ( * ) operator twice on both sides of the text and we can even underline our text using the ( _ ) operator twice on both sides of the text. I show you how in the following example!. Link to example

~~I am a strikethrough text!~~

*I am in italics*

**I am bold text**

__I am underlined text__

It is important to mention that these can be combined, an example of this can be: a text in italic bold or a text in italic bold and strikethrough, etc.

Separators

In Markdown we can separate our text by using horizontal lines in it. There are three different ways to create a horizontal line in our text. Let’s see them! Link to example

# Separate me!!!

***
# Another way to separate me!

---
# Another way to break me apart!

___

Any form is valid use the one you like best!

In Markdown the assertion of images and links is quite similar so these two are side by side. In the following example I show you how to insert images and links. Link to example

[I am a link to google](https://www.google.es/)
![I am an image of a waterfall](https://images.unsplash.com/photo-1544519954-6aeb4816f0ab?ixlib=rb-4.0.3&ixid=MnwxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8&auto=format&fit=crop&w=1974&q=80)

Lists

In Markdown there are three types of ordered, unordered and task lists.

Ordered lists

Unordered lists are defined as follows. Link to example

1. I am
2. A
3. Ordered
4. List
5. :)

Unordered lists

Ordered lists can be defined in two different ways. Link to example

* I am
* A
* unordered
* list
* :)

Link to example

- I am
- A
- unordered
- list
- :)

Any form is valid use the one you like best!

Task lists

Task lists are defined as follows. Link to the example

- [x] Hello
- [ ] World
- [ ] Wadev

Code blocks

Markdown also allows us the assertion of code blocks in our document, highlighting it if we indicate the language, I show you how!. Link to the example

```javascript
console.log("Hello World!")
```

Tables

The tables are defined as follows. Link to the example

| Column1     | Column2     |
|-------------|-------------|
| Row1Column1 | Row1Column2 |
| Row2Column1 | Row2Column2 |

Quotes

To add quotes to the document we only have to use the operator ( > ) in front of the text we want to quote, let’s see an example an example. Link to the example

> I am a quote!!!!

Conclusions

In this article we have seen the different operators available in Markdown, a simple and easy-to-use markup language used for writing and formatting text on a variety of platforms.