Mastering Markdown: Complete Syntax Guide for Developers

What is Markdown?

Markdown is a lightweight markup language created by John Gruber in 2004. It uses plain-text syntax to format documents, making it easy to write and read without complex HTML tags. Markdown is used everywhere: GitHub README files, blog posts, documentation, and messaging apps.

Basic Markdown Syntax

Headings

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

Text Formatting

**Bold text**
*Italic text*
***Bold and italic***
~~Strikethrough~~
`Inline code`

Lists

Unordered list:

- Item one
- Item two
  - Nested item
  - Another nested item

Ordered list:

1. First item
2. Second item
3. Third item

Links and Images

[Link text](https://example.com)
[Link with title](https://example.com "Title")
![Alt text](image-url.png)

Blockquotes

> This is a blockquote.
> It can span multiple lines.
>
> > Nested blockquotes work too.

Code Blocks

Inline code: Use backticks around code: `code`

Fenced code blocks with syntax highlighting:

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

Tables

| Header 1 | Header 2 | Header 3 |
|----------|----------|----------|
| Cell 1   | Cell 2   | Cell 3   |
| Cell 4   | Cell 5   | Cell 6   |

Horizontal Rules

---
***
___

Advanced Markdown

Task Lists

- [x] Completed task
- [ ] Incomplete task
- [ ] Another task

Footnotes

Here's a sentence with a footnote[^1].

[^1]: This is the footnote content.

Definition Lists

Term
: Definition of the term

Another Term
: Its definition

Math (LaTeX)

Inline math: $E = mc^2$

Block math:
$$
\sum_{i=1}^{n} i = \frac{n(n+1)}{2}
$$

Try It: Markdown Preview Tool

Use our Markdown Preview to see your Markdown rendered in real-time as you type.

Markdown Cheat Sheet Quick Reference

| Element | Syntax | Result | |---------|--------|--------| | Heading | # H1 | Large heading | | Bold | **text** | text | | Italic | *text* | text | | Link | [text](url) | Clickable link | | Image | ![alt](url) | Image | | Code | `code` | Inline code | | List | - item | Bullet point |

Markdown Tools for Developers

• Markdown Preview: Preview Markdown as rendered HTML in real-time
• Markdown Editor: Write Markdown with a live side-by-side preview
• Markdown to HTML: Convert Markdown to HTML for web pages
• HTML to Markdown: Convert HTML back to clean Markdown
• Markdown Table Generator: Generate Markdown tables from data
• Markdown Cheatsheet: Quick reference for all Markdown syntax

Best Practices

1. Use headings hierarchically: Start with H1, then H2, then H3
2. Keep line lengths reasonable: Break long paragraphs for readability
3. Use fenced code blocks: Specify language for syntax highlighting
4. Add alt text to images: Improves accessibility
5. Test before publishing: Use our Markdown Preview to verify formatting

Conclusion

Markdown is an essential skill for developers. Practice with our Markdown Editor and convert between formats using our Markdown to HTML converter.