Berkay Çubuk

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


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.


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


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.


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.


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


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>


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


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:


echo "Hello World";


MarkdownHTMLGo to [Google](``Go to <a href="">Google</a>


Subscribe to my newsletter

I share weekly newsletter about my ideas and interesting information I found.

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!