Markdown
June 2, 2026 3 min read

Basic to advanced markdown tutorial

Hs
Hemant singh
Technical Writer & Educator

What is Markdown?

Markdown is a lightweight markup language used for formatting plain text. It converts plain text into structured HTML, making it ideal for documentation, blogs, and more.

Step 1: Basics of Markdown

1. Headings

Use # to create headings. The number of # symbols determines the heading level (1-6).

# Heading 1
## Heading 2
### Heading 3
#### Heading 4
##### Heading 5
###### Heading 6

2. Paragraphs

Simply type text for a paragraph. Leave a blank line between paragraphs.

This is a paragraph.

3. Line Breaks

Add two spaces at the end of a line or use <br>.

This is a line with a  
line break.

4. Bold and Italic

  • Bold: Use ** or __
  • Italic: Use * or _
  • Bold and Italic: Use a combination of *** or ___
**Bold Text**  
*Italic Text*  
***Bold and Italic Text***

5. Lists

Unordered List:

Use -*, or + followed by a space.

- Item 1
- Item 2
  - Sub-item 1
  - Sub-item 2

Ordered List:

Use numbers followed by a period.

1. Item 1
2. Item 2
   1. Sub-item 1
   2. Sub-item 2

6. Links

Use [link text](URL) for hyperlinks.

[Visit Google](https://www.google.com)

Step 2: Intermediate Markdown

1. Images

Use ![alt text](image URL).

![Markdown Logo](https://upload.wikimedia.org/wikipedia/commons/4/48/Markdown-mark.svg)

2. Blockquotes

Use > for blockquotes.

> This is a blockquote.

3. Code

Inline Code:

Use backticks ` for inline code.

Here is some `inline code`.

Code Blocks:

Use triple backticks (```) for code blocks.

<details><summary>Example:</summary>

```python
def hello_world():
    print("Hello, World!")

5. Tables

Use | and - to create tables.

| Column 1 | Column 2 | Column 3 |
|----------|----------|----------|
| Data 1   | Data 2   | Data 3   |
| Data A   | Data B   | Data C   |

Step 3: Advanced Markdown

1. Nested Blockquotes

Combine > for nested quotes.

> Quote level 1
>> Quote level 2
>>> Quote level 3

2. Task Lists

Use - [ ] for unchecked tasks and - [x] for checked tasks.

- [x] Task 1
- [ ] Task 2
- [ ] Task 3

3. Footnotes

Add footnotes using [^].

Here is a footnote example.[^1]

[^1]: This is the footnote text.