Skip to content
HALOWERK

Formatwerk

markdown slides

Splits Markdown into slides at --- lines (fenced code respected) or at headings, extracts speaker notes (lines after Note:/Notes: and HTML comments), converts slides with marked (raw HTML shown as text, only http/https/mailto links and data: images) and prints them with headless Chrome at 1280x720 or 1024x768 px per slide (scripts off, network blocked). Overfull slides are measured and scaled down to at most 50 %; slides that still overflow are reported. PDF only, no PPTX.

POST https://format.halowerk.com/v1/markdown-slides

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
markdownstringYes
split_onstringNo
aspectstringNo
themestringNo
slide_numbersbooleanNo
footer_textstringNo
title_slideobjectNo
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "markdown"
  ],
  "properties": {
    "markdown": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200000
    },
    "split_on": {
      "type": "string",
      "enum": [
        "separator",
        "h1",
        "h2"
      ],
      "default": "separator"
    },
    "aspect": {
      "type": "string",
      "enum": [
        "16:9",
        "4:3"
      ],
      "default": "16:9"
    },
    "theme": {
      "type": "string",
      "enum": [
        "light",
        "dark"
      ],
      "default": "light"
    },
    "slide_numbers": {
      "type": "boolean",
      "default": true
    },
    "footer_text": {
      "type": "string",
      "maxLength": 120
    },
    "title_slide": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "title"
      ],
      "properties": {
        "title": {
          "type": "string",
          "maxLength": 150
        },
        "subtitle": {
          "type": "string",
          "maxLength": 200
        },
        "author": {
          "type": "string",
          "maxLength": 120
        },
        "date": {
          "type": "string",
          "maxLength": 60
        }
      }
    }
  }
}

Open original schema

Published input example

{
  "markdown": "# Agenda\n\n- Status\n- Next steps\n\n---\n\n# Status\n\nAll sensors online.\n\nNote: mention the outage on Monday",
  "aspect": "16:9"
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub โ†’