A Complete Markdown Tutorial: From Basics to Advanced
MD MAHBUB UDDIN

MD MAHBUB UDDIN @mahbubumithu

About: I'm a tech enthusiast with a passion for exploring new technologies and tools. With over 10 years of experience in the IT solutions field.

Location:
Dhaka, Bangladesh
Joined:
Oct 24, 2024

A Complete Markdown Tutorial: From Basics to Advanced

Publish Date: Oct 24 '24
17 18

Markdown is a lightweight markup language that makes it easy to format text. It’s used widely across many platforms like GitHub, Dev.to, and more for creating well-structured documents, from README files to blogs and even documentation.

In this tutorial, I’ll walk you through the essentials of Markdown—from basic syntax to advanced formatting techniques that will help you create more professional and visually engaging content.

Table of Contents

Basic Markdown Syntax

Intermediate Features

Advanced Markdown


Basic Markdown Syntax

  • Headings (L1-L6)
# Bangladesh

## Bangladesh

### Bangladesh

#### Bangladesh

##### Bangladesh

###### Bangladesh
Enter fullscreen mode Exit fullscreen mode

This will display as:

Bangladesh

Bangladesh

Bangladesh

Bangladesh

Bangladesh
Bangladesh

  • Paragraphs

To create paragraphs, just write text on a new line. You don’t need to add any special syntax—just hit "Enter" twice for spacing between paragraphs.

_italic_ or _italic_  
**bold** or **bold**
Enter fullscreen mode Exit fullscreen mode

This will display as:

Bangladesh

Bangladesh


  • Blockquotes
> Respect for my Country
Enter fullscreen mode Exit fullscreen mode

This will display as:

Respect for my Country


  • Lists

    • Unordered List:
- Item 1
- Item 2
  - Sub-item 1
  - Sub-item 2
Enter fullscreen mode Exit fullscreen mode

This will display as:

  • Item 1
  • Item 2

    • Sub-item 1
    • Sub-item 2
    • Ordered List:
1. First item
2. Second item
Enter fullscreen mode Exit fullscreen mode

This will display as:

  1. First item
  2. Second item

  • Hyperlink
[Google](http://google.com)
Enter fullscreen mode Exit fullscreen mode

This will display as:

Google


  • Images
![Github](https://github.blog/wp-content/uploads/2024/07/github-logo.png)
Enter fullscreen mode Exit fullscreen mode

This will display as:

Github

Hyperlink and Images both syntax are same expect one exclamation mark (!) which is point beginning of the Images tag.


Intermediate Features

  • Code Blocks & Syntax Highlighting

For Single Line Code (between single backticks ‘‘):

`print("Hello Bangladesh!")`
Enter fullscreen mode Exit fullscreen mode

This will display as:

print("Hello Bangladesh!")

For multi-line code blocks( between triple backticks ‘‘‘‘‘‘):

    ```

python
    def hello_bangladesh():
    print("Hello Bangladesh!")


    ```
Enter fullscreen mode Exit fullscreen mode

This will display as:

def hello_bangladesh():
    print("Hello Bangladesh!")
Enter fullscreen mode Exit fullscreen mode

  • Tables
| Header 1 | Header 2 |
| -------- | -------- |
| Row 1    | Data 1   |
| Row 2    | Data 2   |
Enter fullscreen mode Exit fullscreen mode

This will display as:

Header 1 Header 2
Row 1 Data 1
Row 2 Data 2

  • Horizontal Lines
---
Enter fullscreen mode Exit fullscreen mode

This will display as:


Advanced Markdown

  • Escaping Characters
\# Not a heading
Enter fullscreen mode Exit fullscreen mode

This will display as:

# Not a heading


  • Task Lists
- [x] Task 1
- [ ] Task 2
Enter fullscreen mode Exit fullscreen mode

This will display as:

  • [x] Task 1
  • [ ] Task 2

  • Nested Lists
1. Item 1
   - Sub-item 1
   - Sub-item 2
2. Item 2
   - Sub-item 1
   - Sub-item 2
Enter fullscreen mode Exit fullscreen mode

This will display as:

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

  • Markdown in HTML
<h2>Custom HTML Header</h2>
<p>This is a paragraph with <strong>bold</strong> text.</p>
Enter fullscreen mode Exit fullscreen mode

This will display as:

Custom HTML Header

This is a paragraph with bold text.

This allows for greater flexibility, especially if you're embedding media or using specific styles.

Website where you can practices markdown live
MarkdownLivePreview

Don’t wait for the perfect moment to learn Markdown. The power to simplify and enhance your writing is already within your reach. Start today, and watch how this simple tool transforms the way you create, share, and collaborate.

Remember: great content starts with a solid foundation—and that foundation is Markdown.


To everyone who has taken the time to read this post—thank you! I hope this Markdown tutorial has empowered you to take the next step in your journey, whether you're a beginner or someone looking to polish their skills. Remember, learning is a continuous process, and even small steps lead to great achievements.

As you venture into new projects, may you find inspiration and joy in everything you create. Whether you're crafting code, writing blogs, or documenting your ideas, may your path be filled with success, creativity, and growth. Keep pushing boundaries, exploring new horizons, and never stop learning!

Wishing you all the best in your endeavors—let’s keep creating amazing things together!

Comments 18 total

  • Boopathi
    BoopathiOct 24, 2024

    This is a fantastic overview of Markdown! I especially appreciate the clear examples and the breakdown of advanced features like code blocks and tables. This tutorial is a great resource for anyone wanting to learn Markdown.

    • MD MAHBUB UDDIN
      MD MAHBUB UDDINOct 25, 2024

      Thank you! 😊 I'm glad you found the tutorial helpful! Let me know if there's anything specific you'd like to see in future Markdown tips.

  • Nikhil Dev Chunchu
    Nikhil Dev ChunchuOct 25, 2024

    Some of the code block are no displaying properly, ex: Horizontal Lines
    `markdown

    • MD MAHBUB UDDIN
      MD MAHBUB UDDINOct 25, 2024

      Thanks for the heads-up! It’s strange because the code blocks are displaying correctly on other platforms and even on Markdown viewers. I’ll look into why it’s not working here—it might be a platform-specific formatting issue. Appreciate your patience and feedback!

    • MD MAHBUB UDDIN
      MD MAHBUB UDDINOct 25, 2024

      Already Fixed this issue.

  • Martin Baun
    Martin BaunOct 25, 2024

    Wonderfully written and researched!

    • MD MAHBUB UDDIN
      MD MAHBUB UDDINOct 25, 2024

      Thanks for checking it out! Let me know if there’s anything specific you’d like me to cover next time!

  • gokayburuc.dev
    gokayburuc.devOct 25, 2024

    Add also Github TOC

    • MD MAHBUB UDDIN
      MD MAHBUB UDDINOct 25, 2024

      Great suggestion! I'll add a section on creating a TOC for GitHub soon. Thanks for the idea—stay tuned!

    • MD MAHBUB UDDIN
      MD MAHBUB UDDINOct 25, 2024

      Already Added. Thanks Again

  • Istiqur Rahman
    Istiqur RahmanOct 25, 2024

    I have liked your writing.
    I am from Bangladesh too. I am glad to be a part of the community.

    • MD MAHBUB UDDIN
      MD MAHBUB UDDINOct 25, 2024

      Thank you so much brother! 😊 Glad to have you in the community—let’s keep learning and growing together!

  • MorphZG
    MorphZGOct 25, 2024

    Once you master markdown you will use it everywhere. Buty of it is plain text formated so it can display almost everywhere, even if it is displayed as plain text you will like the style. I use it mostly for note taking and readme files.

    • MD MAHBUB UDDIN
      MD MAHBUB UDDINOct 25, 2024

      Thanks for sharing how you use it—glad to hear from a fellow Markdown fan!

  • Samuel Rouse
    Samuel RouseOct 25, 2024

    Thanks for putting this together! Markdown is a great tool with a lot of capabilities, but the different versions create variations and ambiguities in the spec. This in turn creates headaches like the ones with your code examples.

    Because of the different versions and implementation inconsistency I recommend adding two resources to your markdown arsenal:

    • CommonMark – A markdown specification with better clarity and compatibility
    • babelmark3 - A tool to see and compare the output of different markdown engines for a given input.
    • MD MAHBUB UDDIN
      MD MAHBUB UDDINOct 25, 2024

      Thank you for the valuable feedback! 😊 You’re absolutely right—Markdown’s different versions can cause inconsistencies, which can be frustrating. Thanks again for sharing these great resources!

  • Aayush Singh
    Aayush SinghJan 5, 2025

    great article! explained markdown in simple word and straightforward

Add comment