{
  "openapi": "3.0.1",
  "info": {
    "title": "Markdown to PDF & Word: Reports with Diagrams, Math & Tables",
    "description": "Convert Markdown to PDF, Word (DOCX) or HTML with tables, code highlighting, Mermaid diagrams, LaTeX math, a table of contents and page numbers. Built for AI agents and automations: send Markdown or links, get file links back.",
    "version": "0.1",
    "x-build-id": "FHzpIdjFoggdvVz1y"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/jumblemog~markdown-to-pdf/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-jumblemog-markdown-to-pdf",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/jumblemog~markdown-to-pdf/runs": {
      "post": {
        "operationId": "runs-sync-jumblemog-markdown-to-pdf",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/jumblemog~markdown-to-pdf/run-sync": {
      "post": {
        "operationId": "run-sync-jumblemog-markdown-to-pdf",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "markdown": {
            "title": "Markdown",
            "type": "string",
            "description": "The document in Markdown (GitHub style): headings, lists, tables, code, task lists, footnotes, ```mermaid diagrams, $math$ and $$display math$$, and YAML front matter with a title, author and date."
          },
          "markdownUrls": {
            "title": "Links to Markdown files",
            "type": "array",
            "description": "Direct links to .md files, GitHub or GitLab file pages (converted to the raw file), or Google Drive and Dropbox share links. Relative images in these files are loaded from next to them.",
            "items": {
              "type": "string"
            }
          },
          "documents": {
            "title": "More documents (batch)",
            "type": "array",
            "description": "A list of documents to convert in the same run. Each entry is a Markdown string, or an object with \"markdown\" or \"url\" and an optional \"name\" for the file."
          },
          "formats": {
            "title": "Formats",
            "type": "array",
            "description": "pdf (default), docx for Microsoft Word, Google Docs and LibreOffice (with native Word equations), and html for a single self-contained web page.",
            "items": {
              "type": "string",
              "enum": [
                "pdf",
                "docx",
                "html"
              ],
              "enumTitles": [
                "PDF",
                "Word (DOCX)",
                "HTML page"
              ]
            },
            "default": [
              "pdf"
            ]
          },
          "theme": {
            "title": "Theme",
            "enum": [
              "default",
              "serif",
              "compact"
            ],
            "type": "string",
            "description": "default: clean sans-serif. serif: a classic report or paper with justified text. compact: smaller headings and tighter spacing. Applies to PDF and HTML.",
            "default": "default"
          },
          "pageSize": {
            "title": "Page size",
            "enum": [
              "A4",
              "Letter",
              "Legal",
              "A5",
              "Tabloid"
            ],
            "type": "string",
            "description": "Paper size of the PDF.",
            "default": "A4"
          },
          "landscape": {
            "title": "Landscape",
            "type": "boolean",
            "description": "Turn PDF pages sideways, for wide tables.",
            "default": false
          },
          "margins": {
            "title": "Margins",
            "enum": [
              "normal",
              "narrow",
              "wide"
            ],
            "type": "string",
            "description": "PDF page margins: normal (18 mm), narrow (12 mm) or wide (25 mm).",
            "default": "normal"
          },
          "fontSize": {
            "title": "Font size (pt)",
            "minimum": 8,
            "maximum": 16,
            "type": "integer",
            "description": "Body text size for PDF and HTML, from 8 to 16 points.",
            "default": 11
          },
          "tableOfContents": {
            "title": "Table of contents",
            "type": "boolean",
            "description": "Add a table of contents built from the headings, on its own page.",
            "default": false
          },
          "pageNumbers": {
            "title": "Page numbers",
            "type": "boolean",
            "description": "Print page numbers (\"3 / 12\") at the bottom of PDF pages.",
            "default": true
          },
          "maxDocuments": {
            "title": "Maximum documents",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "Stop after this many documents, so the cost of a run stays predictable.",
            "default": 100
          },
          "customCss": {
            "title": "Custom CSS",
            "type": "string",
            "description": "Your own CSS for PDF and HTML output, added after the theme. For example brand colors: h1, h2 { color: #0b5394; } or a different font size for tables: table { font-size: 9pt; }. Word files keep the built-in styles."
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}