> For the complete documentation index, see [llms.txt](https://help.are.na/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.are.na/docs/getting-started/blocks/adding-blocks.md).

# Adding blocks

Adding content to Are.na

There are many ways to get content into Are.na. Let's look a few of the ways below.

***

### Dragging files into a channel

You can select files from your computer and drag them straight into a channel.

{% embed url="<https://vimeo.com/1202248768>" %}

### Pasting text

You can also paste text directly into the "Add Block" prompt at the top left of your channel. We support [Markdown for formatting](#formatting-text).

{% embed url="<https://vimeo.com/1202250231>" %}

### Pasting a URL

If you paste a URL to an image, a webpage, a YouTube link, a Vimeo, a Soundcloud, etc, we will automatically figure out what to do with it.

{% embed url="<https://vimeo.com/1202262640>" %}

### Formatting text

We support markdown to format text in text blocks. See the cheatsheet below, but there is a little inline cheatsheet on Are.na if you click the "FORMATTING" button.

<figure><img src="https://3477914774-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYHdbQfmTtGrkgTWzb7VG%2Fuploads%2FlVpqyvGhvPHRYYZpvb00%2FScreenshot%202024-01-22%20at%205.59.53%E2%80%AFPM.png?alt=media&amp;token=80332b37-2bca-4993-bcf5-cc9f8f2ee837" alt=""><figcaption><p>Look for this button to display Markdown cheatsheet</p></figcaption></figure>

<pre><code>Italic
*italic* or _italic_

<strong>Bold
</strong>**bold** or __bold__

Combined
**bold and _italic_**

Horizontal rule
---

Strikethrough
~~strike this~~

Highlighted
==highlighted==

Ordered list
1. List item

Unordered list
- List item

Links
[link text](link URL)

Inline code
`code`

Multiline code
```multiline code```

Blockquote
> I'm a quote

Headers
# h1 
## h2 
### h3 
#### h4 
</code></pre>

### Using the browser extension

We have browser extensions for Chrome (and any Chrome-like browser), Firefox, and Safari. This is the best way to save content while you're browsing the Internet. See [Browser extension](/docs/getting-started/browser-extension.md).

### Limitations

Image uploads are limited to 25MB and video files are limited to 250MB.

### Content guidelines

For questions about what content is acceptable on Are.na, please see our [community guidelines](https://www.are.na/community-guidelines).


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.are.na/docs/getting-started/blocks/adding-blocks.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.