Markdown Basics: Complete Beginner's Guide

Markdown is a lightweight markup language that lets you format text using simple, intuitive symbols. Created by John Gruber in 2004, it has become the standard for writing documentation, README files, blog posts, and more. The beauty of Markdown is its simplicity—you can learn the basics in minutes and start writing formatted content immediately.

This guide covers everything you need to know to start writing in Markdown, from basic text formatting to links and images.

Headings

Create headings by starting a line with hash symbols (#). The number of hashes determines the heading level:

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

Always include a space after the hash symbols. Use heading levels hierarchically—start with H1 for your title, then H2 for main sections, H3 for subsections, and so on.

Text Formatting

Markdown makes it easy to emphasize text:

• Bold - Wrap text with double asterisks: **bold text**
• Italic - Wrap text with single asterisks: *italic text*
• Bold and Italic - Combine them: ***bold and italic***
• Strikethrough - Wrap with double tildes: ~~strikethrough~~
• Inline code - Wrap with backticks: `code`

Lists

Unordered Lists

Create bullet points with dashes, asterisks, or plus signs:

- First item
- Second item
- Third item

Ordered Lists

Use numbers followed by periods:

1. First step
2. Second step
3. Third step

Nested Lists

Indent with spaces to create nested items:

- Main item
  - Sub-item
  - Another sub-item
- Another main item

Links and Images

Links

Create clickable links with this syntax:

[Link text](https://example.com)

Example: [Visit Markdown2ANY](https://markdown2any.com)

Images

Images use similar syntax with an exclamation mark:

![Alt text](image-url.jpg)

The alt text describes the image for accessibility.

Blockquotes

Create quoted text by starting lines with a greater-than symbol:

> This is a blockquote.
> It can span multiple lines.

Blockquotes are perfect for citing sources or highlighting important information.

Horizontal Rules

Create a horizontal divider with three or more dashes, asterisks, or underscores:

---

Code Blocks

For multi-line code, use triple backticks. Specify the language for syntax highlighting:

```javascript
function greet(name) {
  return `Hello, ${name}!`;
}
```

This creates a formatted code block with proper highlighting.

Paragraphs and Line Breaks

Create paragraphs by leaving a blank line between text blocks. For a line break within a paragraph, end the line with two spaces or use <br>.

Next Steps

Now that you know the basics, you can:

• Practice with our live Markdown preview tool
• Learn about advanced Markdown features like tables and task lists
• Start converting your Markdown to other formats