Skip to content

Markdown How-To Guide

Markdown is a lightweight markup language used to format plain text. It's commonly used for writing documentation, blogs, and more.

1. Headings

Use # symbols to create headings. The number of # determines the heading level.

Example:

markdown
# Heading 1
## Heading 2
### Heading 3

2. Emphasis

You can italicize, bold, or bold and italicize text.

  • Italics: *italic* or _italic_italic
  • Bold: **bold** or __bold__bold
  • Bold and Italic: ***bold and italic***bold and italic

3. Lists

Unordered Lists

Use -, +, or * for bullet points.

Example:

markdown
- Item 1
- Item 2
  - Sub-item

Ordered Lists

Use numbers followed by a period.

Example:

markdown
1. First item
2. Second item
   1. Sub-item

Create links using [link text](URL).

Example:

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

5. Images

Add images using ![alt text](image URL).

Example:

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

6. Code

Inline Code

Use backticks ` to create inline code.

Example:

markdown
This is `inline code`.

Code Blocks

Use triple backticks for code blocks.

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

7. Blockquotes

Use > for blockquotes.

Example:

markdown
> This is a blockquote.

8. Horizontal Rules

Use --- or *** to create horizontal rules.

Example:

markdown
---

9. Tables

Use pipes | and hyphens - to create tables.

Example:

markdown
| Header 1 | Header 2 |
|----------|----------|
| Row 1    | Data     |
| Row 2    | More Data|

10. Task Lists

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

Example:

markdown
- [x] Task 1
- [ ] Task 2

11. Escaping Special Characters

Use a backslash \ to escape special characters.

Example:

markdown
\*Not italic\*

With these basics, you can format most Markdown documents!