> For the complete documentation index, see [llms.txt](https://help.getupnote.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.getupnote.com/write-and-edit/format-your-text/write-with-markdown.md).
# Write with Markdown
Markdown has become popular nowadays, especially among developers. It helps you format the note easily without having to write bloated HTML code. If you already know Markdown syntax, you will feel at home.
### Headings
To create a heading, add number signs **`#`** in front of a word or phrase, followed by a space. The number of number signs you use should correspond to the heading level.
| Markdown | Output |
| --------------------- | ------------------------ |
| `# Heading level 1` | Heading level 1
|
| `## Heading level 2` | Heading level 2
|
| `### Heading level 3` | Heading level 3
|
### Bold
To bold text, add two asterisks **`**`** or underscores **`__`** before and after a word or phrase.
| Markdown | Output |
| --------------- | ------------- |
| `**bold text**` | **bold text** |
| `__bold text__` | **bold text** |
### Italic
To italicize text, add one asterisk **`*`** or underscore **`_`** before and after a word or phrase.
| Markdown | Output |
| ------------------- | ----------------- |
| `*italicized text*` | *italicized text* |
| `_italicized text_` | *italicized text* |
### Bold and Italic
To emphasize text with bold and italics at the same time, add three asterisks or underscores before and after a word or phrase.
| Markdown | Output |
| ---------------------------- | -------------------------- |
| `***bold and italic text***` | ***bold and italic text*** |
| `___bold and italic text___` | ***bold and italic text*** |
### Block quotes
To create a blockquote, add a **`>`** in front of a paragraph, followed by a space.
| Markdown | Output |
| ------------------------- | -------------------------------- |
| `> This is a blockquote.` |  |
### List
To create an ordered list, add line items with numbers followed by periods.
| Markdown | Output |
| ----------------------------------------------------------------------------------------------- | -------------------------------------------------------------- |
| 1. Item one
2. Item two
3. Item three
| - Item one
- Item two
- Item three
|
To create an unordered list, add dashes **`-`**, asterisk **`*`**, or plus sign **`+`** in front of line items. Indent one or more items to create a nested list.
| Markdown | Output |
| -------------------------------------------------------------------------------------------- | -------------------------------------------------------------- |
| - Item one
- Item two
- Item three
| - Item one
- Item two
- Item three
|
### Code
To create a code block, use 3 backticks **` ``` `** .
To denote a word or phrase as code, enclose it in backticks **`` ` ``**.
| Markdown | Output |
| ---------------- | -------------------------------- |
| \`in-line code\` | `in-line code` |
| \`\`\`code block |  |
### Divider
To create a divider, use three asterisks **`***`**, dashes **`---`**, or underscores **`___`** on a line by themselves and hit **`Enter`**.
| Markdown | Output |
| -------- | -------------------------------- |
| --- |  |
### Checkbox
To add a todo item, use **`[]`** followed by a space.
To add a done item, use **`[x]`** followed by a space.
| Markdown | Output |
| --------------- | ------------------------------------------------------------------------------------- |
| `[] todo item` | |
| `[x] done item` | |
### Copy as Markdown
To copy content from UpNote as markdown, right click and select **`Copy as Markdown`**
You may also use the shortcut **`Cmd` + `Option` + `C`** (on Mac) and **`Ctrl` + `Alt` + `C`** (on Windows)
### Paste from Markdown
If you want to paste from a Markdown source, right click on your editor and select **`Paste from Markdown`***.* Your content will be automatically converted to proper format.
You may also use the shortcut **`Cmd` + `Option` + `V`** (on Mac) and **`Ctrl` + `Alt` + `V`** (on Windows)
On iOS, long tap on the editor and select **`Paste from Markdown`** in the pop up.\
On Android, tap the **`+`** icon in the formatting bar and select **`Paste from Markdown`**\
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://help.getupnote.com/write-and-edit/format-your-text/write-with-markdown.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.