Markdown formatting in Favro

Favro's card descriptions and comments support rich text formatting. In the editor, you format text using the toolbar or keyboard shortcuts.

This article covers what formatting is available, how to use it, and what it looks like when you read or write card descriptions through the Favro API.

Formatting available in Favro

Here's a quick overview of every formatting option Favro supports.

How it looks in Favro cards:

How it looks in markdown format:

# Heading 1

## Heading 2

**Bold**

*Italic*

~~Strikethrough~~

[Link](https://www.favro.com)

```
// Code block
```

`inline code`

* Bullet list

  * Item 1

  * Item 2

|Table Heading|Table Heading|Table Heading|
| --- | --- | --- |
|Multi-line<br>Table cell|Table cell|Table cell|

- [ ] Checklist item

- [x] Multi-line
  Checklist item

## Attachments
[Board](https://favro.com/widget/.../...)

[Another card](https://favro.com/organization/.../...?card=Fav-5840)

![image.png](https://favro...

Blockquotes

Use a blockquote to quote or call out content in a card description. Start a line with > and it becomes a quote, the same way * starts a bullet list. You can also add it from the toolbar or from quickinsert.

Blockquotes support the same rich content as the rest of the card: lists, checklists, images, and attachments all work inside a quote, and you can nest quotes within quotes. Content pasted from external tools or an AI assistant keeps its quote structure and round-trips through markdown.

How this looks in markdown:

> Blockquote

> Blockquote with rich content
> * List item inside a quote
> - [ ] Checklist inside a quote

> > Nested blockquote

Pasting and copying markdown

You can move formatted content in and out of Favro cards as markdown.

Paste markdown in: Copy markdown from an external tool like an AI assistant, Notion, a doc and paste it into a card description. Favro detects the markdown and converts it to rich content automatically. Headings, lists, checklists, tables, links, and code blocks all come through formatted.

Copy a card out as markdown: Open the card editor menu and choose "Copy description as markdown." The full description is copied as markdown, ready to paste elsewhere.

Paste as plain text: To paste without any formatting, use Shift + Cmd + V (Shift + Ctrl + V on Windows). The content comes in as plain text with no conversion.

For API developers

Use the descriptionFormat markdown, to

Working with attachments

Attachments in a card description come through as standard markdown syntax.

If you read a description, modify it, and write it back, those references stay intact, provided you did not modify anything related to the attachments.

To add new file attachments, use the dedicated upload endpoints instead: API reference Attachments

Caveats when using markdown API

Updating cards through markdown API will remove highlights from all comments.
Text alignment in tables is not persisted in markdown