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

# Markdown

> Markup with Markdown

Markdown is the lightweight, easy to learn, human-readable markup language that powers refile.

Think of markdown as a way to write text while specifying its formatting.

This is just a rough guide, for more information on markdown, please visit [markdowntutorial.com](https://www.markdowntutorial.com/).

## Headings

To create headings, add pound symbols (#) at the beginning of a line, followed by a space. The number of pound symbols corresponds to the heading level:

```markdown theme={null}
# Heading level 1

## Heading level 2

### Heading level 3

#### Heading level 4

##### Heading level 5

###### Heading level 6
```

**Best Practices for Headings:**

* Always include a space between the # symbols and your heading text
* Leave a blank line before and after headings for better readability

## Text Formatting

### Bold Text

To make text **bold**, add two asterisks or two underscores before and after the text:

```markdown theme={null}
**This text is bold**
**This text is also bold**
```

You can also make part of a word bold using asterisks: `This is a **bold** word`

### Italic Text

To make text *italic*, add one asterisk or one underscore before and after the text:

```markdown theme={null}
_This text is italic_
_This text is also italic_
```

Like with bold text, you can italicize part of a word: `This is an *italicized* word`

## Tables

Tables are created using pipes (|) and dashes (-):

```markdown theme={null}
| Header 1 | Header 2 |
| -------- | -------- |
| Cell 1   | Cell 2   |
| Cell 3   | Cell 4   |
```

This renders as:

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

### Text Alignment in Tables

You can align text in columns by adding colons (:) to the header row:

```markdown theme={null}
| Left-aligned | Center-aligned | Right-aligned |
| :----------- | :------------: | ------------: |
| Content      |    Content     |       Content |
```

* `:--` Left alignment
* `:-:` Center alignment
* `--:` Right alignment

## Lists in Markdown

Markdown supports several types of lists to organize your content effectively:

### Unordered Lists

Create unordered (bulleted) lists using hyphens, asterisks, or plus signs followed by a space:

```markdown theme={null}
- Item one
- Item two
- Item three

* Item one
* Item two
* Item three

- Item one
- Item two
- Item three
```

All three methods produce the same bulleted list output, though some editors may only support hyphens (-).

### Ordered Lists

Create numbered lists by starting each line with a number followed by a period and a space:

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

To start numbering from a specific value, use that number for the first item:

```markdown theme={null}
23. Twenty-three
24. Twenty-four
25. Twenty-five
```

### Nested Lists

Create hierarchical lists by indenting with spaces (typically 2 or 4 spaces):

```markdown theme={null}
- First level item
  - Second level item
  - Another second level item
- Another first level item
  1. Numbered sublist
  2. Another numbered item
```

### Task Lists

We support task lists with checkboxes:

```markdown theme={null}
- [ ] Unchecked task
- [x] Completed task
```

## Example Document

Here's a complete example that demonstrates the markdown features we've covered:

```markdown theme={null}
# My Project Documentation

## Introduction

This document provides an **overview** of the _amazing_ features in our project. It serves as a **_quick reference_** for team members.

## Features

### Core Functionality

- [x] User authentication
- [x] Data storage
- [ ] Export capabilities
- [ ] Advanced analytics

### Technical Specifications

| Feature | Status  | Priority |
| :------ | :-----: | -------: |
| Login   |  Done   |     High |
| Search  |  Done   |   Medium |
| Reports | Pending |      Low |

## Implementation Notes

1. Install dependencies
   1. Core libraries
   2. Development tools
2. Configure settings
3. Run initialization script

### Code Example

Our system uses the following approach:

1. Define data models
2. Create API endpoints
3. Implement frontend components

## Next Steps

We need to focus on completing the remaining tasks while maintaining our **high quality standards**.

For more information, visit our [documentation portal](https://example.com/docs).
```

This example demonstrates headings of different levels, text formatting, task lists, tables with alignment, ordered and nested lists, and links - all of which were covered in the previous sections.

You can copy this example and modify it to create your own structured documents in refile.