Docs API limitation

Learn about the limitations of the Docs endpoints.

The Docs API has some formatting limitations compared to the product that are important to be aware of when importing or exporting Docs.

Text

The following elements are supported by plain and markdown text when importing or exporting Docs.

Element

Plain and markdown text support

Normal text

Yes

Heading 1

Yes

Heading 2

Yes

Heading 3

Yes

Heading 4

Yes

Alignment

No

Bulleted List

Yes

Numbered List

Yes

Toggle List

No

Checklist

No

Banner

No

Code Block

Yes, but code formatting is lost

Quote

Yes

Inline

Inline elements are not supported by plain or markdown text when importing or exporting Docs.

Views

Views are not supported by plain and markdown text when importing or exporting Docs.

Embeds

The following embed elements are supported by plain and markdown text when importing or exporting Docs:

Element

Plain and markdown text support

YouTube

No

Vimeo

No

Loom

No

Miro

No

Giphy

No

Google Drive

No

Google Slides

No

Google Docs

No

Google Sheets

No

Attachment

Yes, but sizing is not retained

Embed a task

No

Embed a Doc

No

Embed a Whiteboard

No

Embed org chart

No

Formatting

The following formatting elements are supported by plain and markdown text when importing or exporting Docs:

ElementPlain and markdown text support
BoldYes
ItalicYes
UnderlineNo
StrikethroughYes
IndentNo
Inline codeYes
Website linkYes

Advanced blocks

The following advanced block elements are supported by plain and markdown text when importing or exporting Docs:

ElementPlain and markdown text support
Synced contentNo
ColumnsNo
DividerYes
ButtonYes, but it turns into an unformatted link
Table of contentsNo
TableYes, but it loses formatting
Sticky table of contentsNo
New slideNo

Text colors, background colors, and badges

Text colors, background colors, and badges are not supported by plain and markdown text when importing or exporting Docs.

Covers, icons, comments, page styles, and wikis

Covers, icons, comments, page styles, and wikis are not supported by plain and markdown text when importing or exporting Docs.