> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usestellar.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Markdown Support

> Format content with markdown in insights, features, and announcements

The Stellar editor supports rich markdown formatting across insights, features, and announcements. Create well-structured content with headers, lists, links, and text styling.

\[image]

## Where Markdown Works

Use markdown formatting in:

* **Insight content** - Capture formatted feedback
* **Feature descriptions** - Document requirements
* **Announcement content** - Create engaging updates
* **Comments** - Add formatted discussions

## Supported Formatting

### Headers

Create hierarchy with headers:

```markdown theme={null}
# H1 - Main Title
## H2 - Section Header
```

**Output:**

# H1 - Main Title

## H2 - Section Header

<Note>
  Use H1 sparingly - typically once per document. H2 headers work best for sections.
</Note>

### Text Styling

Format text for emphasis:

```markdown theme={null}
**Bold text** for strong emphasis
*Italic text* for subtle emphasis
<u>Underlined text</u> for highlighting
~~Strikethrough~~ for deprecated content
```

**Output:**

* **Bold text** for strong emphasis
* *Italic text* for subtle emphasis
* <u>Underlined text</u> for highlighting
* ~~Strikethrough~~ for deprecated content

### Links

Create clickable links:

```markdown theme={null}
[Link text](https://example.com)
```

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

\[image]

## Lists

### Bullet Lists

Create unordered lists:

```markdown theme={null}
- First item
- Second item
  - Nested item
  - Another nested item
- Third item
```

**Output:**

* First item
* Second item
  * Nested item
  * Another nested item
* Third item

### Numbered Lists

Create ordered lists:

```markdown theme={null}
1. First step
2. Second step
3. Third step
```

**Output:**

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

### Todo Lists

Track tasks with checkboxes:

```markdown theme={null}
- [ ] Uncompleted task
- [x] Completed task
- [ ] Another todo
```

**Output:**

* [ ] Uncompleted task
* [x] Completed task
* [ ] Another todo

\[image]

<Info>
  Todo lists are perfect for feature requirements or announcement checklists.
</Info>

## Keyboard Shortcuts

Speed up formatting with shortcuts:

| Action        | Mac | Windows |
| ------------- | --- | ------- |
| **Bold**      | ⌘B  | Ctrl+B  |
| **Italic**    | ⌘I  | Ctrl+I  |
| **Underline** | ⌘U  | Ctrl+U  |
| **Link**      | ⌘K  | Ctrl+K  |

## Best Practices

### For Insights

* Use headers to separate different feedback points
* Bold customer names or important quotes
* Use lists for multiple feature requests

### For Features

* H2 headers for requirements sections
* Todo lists for acceptance criteria
* Links to reference documentation

### For Announcements

* H1 for announcement title
* H2 for major sections
* Bold text for key features
* Lists for changelog items

\[image]

## Advanced Tips

**Combine Formatting** - Mix styles for clarity:

```markdown theme={null}
**Important:** This is a *critical* update with ~~deprecated~~ features
```

**Nested Lists** - Organize complex information:

```markdown theme={null}
- Main feature
  - Sub-feature 1
    - Detail A
    - Detail B
  - Sub-feature 2
```

**Clean URLs** - Make links readable:

```markdown theme={null}
Check our [documentation](https://docs.example.com) for details
```

## Common Patterns

### Feature Requirements

```markdown theme={null}
## User Story
As a **user**, I want to *filter features* so that I can find what I need.

## Acceptance Criteria
- [ ] Users can filter by status
- [ ] Filters persist between sessions
- [ ] Multiple filters can be combined
```

### Announcement Structure

```markdown theme={null}
# New Feature: Advanced Filtering

We're excited to announce **powerful new filtering options**!

## What's New
- Filter by multiple properties
- Save filter combinations
- Share filters with your team

[Try it now](https://app.example.com)
```

\[image]

<Tip>
  Preview your content before publishing to ensure formatting appears as intended.
</Tip>

Ready to create beautifully formatted content? Start using markdown to make your insights, features, and announcements more readable and engaging.