Convert PowerPoint (PPTX) to Markdown

Send a .pptx deck to /v1/convert. Each slide comes back with its title as a heading, its text, tables and speaker notes.

Last updated

POST /v1/convert converts a PowerPoint deck (.pptx) to Markdown in one call. Each slide starts with a slide number comment, and the slide title becomes a heading. Speaker notes follow under ### Notes:.

curl

curl -F "file=@deck.pptx;type=application/vnd.openxmlformats-officedocument.presentationml.presentation" \
  https://api.flatmark.dev/v1/convert

The markdown field of the response looks like this:

<!-- Slide number: 1 -->
# Roadmap
Ship the export API

### Notes:
Mention the beta date.

What carries over

  • Text boxes, in order from top to bottom and left to right.
  • Tables as Markdown tables, with the first row as the header.
  • Charts as a table of their data under ### Chart.
  • Pictures as an image link with the alt text. The image itself is not extracted.

Older .ppt files are rejected (415). Decks over 8 MB go to the queue. The queue also returns a JSON file with the slide number of every item.

Next step

Convert a deck in the browser, up to 4 MB and without an account.

FAQ

Are speaker notes included?
Yes. The notes of each slide follow its content under a '### Notes:' heading. Remove that block if you do not want notes in your index.
Does flatmark read older .ppt files?
No. Older .ppt files are rejected with a 415 error. Save the deck as .pptx in PowerPoint and send it again.