Export markdown from doc

Learn how to export markdown from a monday doc using the platform API

🚧 Only available in API versions 2025-10 and later

Workdocs serve as a central place for teams to plan and execute work collaboratively. They're like virtual whiteboards that allow you to jot down notes, create charts, and populate items on a board from the text you type.

Docs enable teams to collaborate in real time without overwriting each other's work. Users can even implement built-in features like widgets, templates, and apps to enhance their docs. When teams need to take that content outside monday, they can export whole docs (or specific blocks) to Markdown via the API.

Queries

You can export a doc's content to markdown via the API through the export_markdown_from_doc query.

  • Required scope: docs:read
  • Returns an object containing a document's markdown content
  • Can only be queried directly at the root; can't be nested within another query
query {
  export_markdown_from_doc(
    docId: 12345, 
    blockIds: ["e4b1c79a-5f2d-4c83-b1a7-0f9e2d6c3a58", "3a7f2c18-91d4-4b6e-a3f2-7c9e12b4d5a6"]
  ){
    error
    markdown
    success
  }
}

Arguments

You can use the following argument(s) to reduce the number of results returned in your export_markdown_from_doc query.

ArgumentDescription
blockIds [String!]The unique identifier of the specific blocks to export. If omitted, this will export the entire document's content.
docId ID!The unique identifier of the document to export.

Fields

You can use the following field(s) to specify what information your export_markdown_from_doc query will return.

FieldDescription
error StringThe errors that occurred while exporting markdown from a doc. Use this field to check for calls that failed.
markdown StringThe exported markdown content as a string.
success Boolean!Whether the document content was successfully exported as markdown.