Text Formatting: Bold, Italic & More

The most common formatting you will use every day:

**Bold text**
*Italic text*
***Both together***

`inline code`
~~strikethrough~~

Headings & Paragraphs

Organize your content with headings. Use one # for the main title, two for sections, and so on:

# Title (largest)
## Section Heading
### Subsection

Leave a blank line between sections to create separate paragraphs. Most of the time, a single blank line is all you need.

Lists: Ordered & Unordered

Lists help you present information clearly:

- First item
- Second item
  - Nested item
  - Another nested
- Third item

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

Use nested lists (with 2 spaces before the nested -) to show sub-items or sub-steps.

Links & Images

Add links to external resources or pages:

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

Add images using the same syntax with an exclamation mark:

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

Alt text describes the image for screen readers and when the image does not load.

Blockquotes

Use > to highlight quoted text:

> This is a blockquote.
> It stands out from regular text.

Blockquotes are great for:

• Calling out important information
• Showing examples of what to do (or not do)
• Adding context from external sources in your documents

Code Blocks

Use fenced code blocks (triple backticks) for multi-line code:

```python
def hello(name):
    print(f"Hello, {name}!")
```

Specify the language after the opening backticks for syntax highlighting:

def hello(name):
    print(f"Hello, {name}!")

Use a single backtick ` for inline code like const x = 5;.

Tables

Tables are one of the most powerful extended features (supported by GitHub, GitLab, and most AI tools):

| Column 1 | Column 2 | Column 3 |
|----------|:---------|--------:|
| Left     | Center   | Right   |
| Data     | Data     | Data    |

The : in the separator row controls alignment: :--- left, :---: center, ---: right.

Task Lists

Create interactive checklists — great for project plans and workflows:

- [x] Completed task
- [ ] Pending task
- [ ] Another pending task

Many platforms (GitHub, Notion, Slack) render these as real checkboxes you can click.

Horizontal Rules

Use three dashes --- on its own line to create a visual separator:

First section content here.

---

Second section content here.

Horizontal rules help break up long documents and make them easier to scan.

Using Markdown with AI Tools

AI tools like Claude, ChatGPT, and Copilot understand Markdown natively. Here is how to use it effectively:

Explain **revenue growth** in simple terms:

1. Define the concept
2. Give an example
3. Show a formula

Use **bullet points**.

# AGENTS.md

## Role
You are a code reviewer...

## Instructions
- Check for security issues
- Verify tests pass...

## Constraints
- Max 500 words per response