Markdown Guide

Mon Nov 16 2020

What is Markdown?

Markdown is a lightweight markup language with plain-text-formatting syntax, created in 2004 by John Gruber and Aaron Swartz.

It’s basically helping us to create rich structured and lighweight text files without special software or editor. You can create your own markdown document with a notepad or any text editor. To create markdown file you have to give it .md extension.

Markdown Basics

Headings

We have 6 different headings in HTML. First one the biggest, last one is the smallest. We’re using # to start using heading. To change it’s level we can add more #. MarkdownDescriptionHTML equivalent# Heading 1Biggest heading<h1>Heading 1</h1>``## Heading 22. heading and going smaller<h2>Heading 2</h2>``### Heading 3 3. heading<h3>Heading 3</h3>``#### Heading 44. heading<h4>Heading 4</h4>``##### Heading 55. heading<h5>Heading 5</h5>``###### Heading 6Smallest heading<h6>Heading 6</h6> Please make sure you give enough space between # and the heading name.

Paragraphs

Just type what you want to display as paragraph. MarkdownDescriptionHTML equivalentParagraph 🙂Simple paragraph in markdown<p>Paragraph 🙂</p>

Bold

We can make some part of text bold. MarkdownHTML equivalentText with **bold** text``Text with <strong>bold</strong> text``Test with __bold__ text``Text with <strong>bold</strong> text In HTML, you can also use <b></b> for bold.

Italic

MarkdownHTML equivalentText with *italic* text``Text with <i>italic</i> text``Text with _italic_ text``Text with <i>italic</i> text In HTML, you can also user <em></em> for italic.

Blockquotes

MarkdownHTML equivalent> Happiness depends upon ourselves.``<blockquote>Happiness depends upon ourselves.</blockquote>

Lists

We can organize items using lists.

Ordered Lists

MarkdownHTML1. First item``<ol><li>First item</li></ol> I don’t like this explanation so the next one will be better.

## Popular code editors

1. VsCode
2. Vim
3. Sublime Text
4. Atom

Unordered Lists

MarkdownHTML- First item``<ul><li>First item</li></ul>``* First item``<ul><li>First item</li></ul>``+ First item``<ul><li>First item</li></ul>

Images

We can display images with markdown. MarkdownHTML![alt text](image url)``<img src="image url" alt="alt text" />

Code

We can display code blocks with unique syntax highligting. MarkdownHTML````print “Hello World” <code>print "Hello World"</code>` To define language you can add the language name after the first . For example:

```php

echo "Hello World";

```

MarkdownHTMLGo to [Google](https://google.com)``Go to <a href="https://google.com">Google</a>

References

Simplified Hugo Book

I'm writing a book to simplify Hugo and allow you to create your own theme just from scratch.

Join the waitlist

Let's make your dream project real!

Book a call with me and maybe we can combine our forces to make your project a reality.

Book a call now!