OPF

Search docs

Loading documentation…
    OpenPresentation/opf
    Browse docs
    On this page

    Export and import PowerPoint

    Hand over an editable PowerPoint file, check it in the recipient’s application and read a PPTX back into OPF.

    Export a PowerPoint file

    Start with a validated deck.opf.json and the CLI and export packages. Run the conversion alongside the source file.

    Export
    npx opf convert deck.opf.json review.pptx

    Open review.pptx. Inspect the slide titles in Outline view and select a table or chart to see which objects you can edit.

    Inspect the PowerPoint handoff

    Each slide title uses the Title placeholder, including titles that wrap. Heading and body runs reference the theme fonts. Change the theme’s fonts to check how the deck restyles. Charts retain their font names. Install the fonts on the viewing computer.

    Body text boxes are ordinary shapes. In the default measured export, editing one line does not reflow the following lines. Use --body-text native for supported reflowing bodies. Selection Pane names are internal.

    When a chart, table, logo or quote photo lacks authored alternative text, the exporter supplies a description. Extended charts keep their editable chart in PowerPoint and include a preview picture for apps such as Keynote when the renderer and rasterizer are available. Check the layout names, notes page and document properties, including tags, language and organization. Read the conversion diagnostics and compare the handoff in the recipient’s application. Windows PowerPoint draws Aptos about 0.06 em higher than the preview.

    Import an existing presentation

    Import and check
    npx opf convert review.pptx imported.opf.json
    npx opf validate imported.opf.json

    Inspect the imported slides alongside the original. SmartArt imports carry readable entries and hierarchy; inspect the import diagnostics for dropped styling or connections. Generated descriptions stay distinct from authored alt, including when the description is stale. The import API example shows how to inspect per-shape signals. Keep the original OPF file for subsequent edits.