# Markdown to PowerPoint (PPTX)

> Editable PowerPoint from Markdown: real titles, bullets, tables, speaker notes and alt text. Converts a Markdown deck into a .pptx file written by hand in Office Open XML: real title placeholders, editable text boxes with bullet levels, bold, italic and links, native tables with a header row, pictures with alternative text, charts and diagrams as pictures with their description, speaker notes and a reading order that follows the Markdown. Opens in PowerPoint, Keynote, LibreOffice Impress and Google Slides.

Part of usefulweb.site (https://usefulweb.site/). Part of [Deckwright](https://deckwright.usefulweb.site/) (ownerApp: deckwright). Results are deterministic calculations from the inputs and the listed assumptions; the API returns exactly what the web page shows.

## Use it
- Human interface: https://deckwrightpptxexport.usefulweb.site/ (interactive tool at https://deckwrightpptxexport.usefulweb.site/tool)
- JSON API: POST https://deckwrightpptxexport.usefulweb.site/api/v1/calculate with a JSON object of inputs (schema: https://deckwrightpptxexport.usefulweb.site/api/v1/tool)
- OpenAPI: https://deckwrightpptxexport.usefulweb.site/openapi.json
- MCP (Streamable HTTP): https://deckwrightpptxexport.usefulweb.site/mcp - tool `deckwright_pptx_export`

## Inputs
- markdown (textarea): Deck in Markdown - Slides are separated by a line ---; without separators every # or ## heading starts a slide. Charts: ```chart blocks with options and CSV; diagrams: ```diagram or ```mermaid blocks; speaker notes after a line Notes:. Images: ![alt text](data:image/png;base64,…).
- theme (select): Theme
- aspect (select): Slide shape
- lang (text): Deck language (BCP 47, e.g. en, de, ar) - Leave empty to use “lang:” from the front matter (English if not set).
- dir (select): Text direction

## Method
- The package follows ECMA-376 PresentationML: presentation, one slide master with a title and a title-and-content layout, a theme with the deck colours and Noto Sans, one slide part per slide, notes pages for slides with speaker notes, and relationships for pictures and hyperlinks.
- Shapes are placed on the same boxes as the PDF layout (millimetres × 36,000 EMU); the slide title uses the title placeholder, so the outline view, the accessibility checker and screen readers see it. Decorative bars are marked decorative.
- Text keeps its Markdown structure: one paragraph per list item with its level and bullet or number, runs with bold, italic, code font and external hyperlinks, right-to-left paragraphs for RTL decks; tables are native with the first row marked as header row.
- Charts and diagrams are rendered to PNG at 200 dpi from the same vector shapes as the PDF and carry their alternative text. The ZIP is written deterministically (fixed timestamps), so equal input gives an identical file.

## Limits
- Charts and diagrams are pictures in the PPTX, not editable PowerPoint charts. Fonts are not embedded in the PPTX: viewers without Noto Sans use a similar sans-serif font, so line breaks can differ slightly from the PDF.