Markdown Basics

Markdown is a lightweight markup language created for writing formatted text using plain text characters.

Instead of HTML tags, Markdown uses simple symbols like:

#  *  -  [ ] ( ) `

These symbols are converted into formatted content when rendered by GitHub, VS Code, Obsidian, Notion, and hundreds of other applications.

Markdown keeps your files clean, portable, and easy to edit — which is why it powers README files, documentation sites, and notes apps worldwide.

Markdown is popular because it is:

• Easy to learn
• Fast to write
• Simple to read
• Supported almost everywhere
• Perfect for documentation
• Ideal for README files
• Great for note taking
• Easy to convert into HTML, PDF, Word, and other formats

Whether you're a developer, student, technical writer, blogger, or AI user, Markdown is worth learning.

You can use Markdown in many popular platforms including:

• GitHub
• GitLab
• Bitbucket
• Obsidian
• Notion
• VS Code
• Discord
• Reddit
• Stack Overflow
• Jupyter Notebook
• Static site generators
• Documentation websites

Learning basic Markdown once allows you to write content across all of these platforms.

Most people follow a simple workflow:

1. Write plain text
2. Add Markdown formatting
3. Preview the rendered output
4. Edit if necessary
5. Export or publish

This makes Markdown much faster than writing HTML manually. Use the Markdown Editor with live preview, or convert existing content with HTML to Markdown when you need to import documents.

Unlike Microsoft Word or Google Docs, Markdown focuses on content instead of formatting buttons.

Instead of clicking Bold, you write:

**Bold Text**

Instead of selecting Heading 1, you simply write:

# Heading

This approach keeps documents cleaner and easier to maintain. For a deeper comparison, read Markdown vs HTML on the blog.

If you're just getting started:

• Learn headings first
• Practice lists and links
• Use code blocks for commands
• Keep formatting consistent
• Preview your document before publishing
• Avoid mixing Markdown and HTML unless necessary

Small habits like these make your documents easier to read. When you need every syntax rule in one place, bookmark the Markdown Cheat Sheet.

Once you're comfortable with the basics, continue with these guides:

Available now

• Markdown Cheat Sheet — quick syntax reference
• Markdown Syntax — complete syntax guide with examples
• Markdown Headings — H1 through H6 with best practices
• Markdown Paragraphs — blank lines and spacing
• Markdown Lists — ordered, unordered, nested, and task lists
• Markdown Links — inline, reference, and relative links
• Markdown Images — syntax, URLs, alt text, and GitHub paths
• Markdown Tables — syntax, alignment, and GitHub GFM

Coming soon to MDConvertHub Docs

• Markdown Code Blocks

Each guide explores one topic in greater detail with examples and best practices.