Skip to content

command view ppt

zmworm edited this page Mar 22, 2026 · 51 revisions

view - PowerPoint (.pptx)

View modes for PowerPoint documents.

text

Plain text extracted from all shapes per slide.

Output format:

=== /slide[N] ===
Text from shape 1
Text from shape 2

=== /slide[N] ===
...
... (showed {N} of {total} slides, use --start/--end to see more)

annotated

Shape type labels, fonts, sizes, equations, pictures with alt text status.

Output format:

[/slide[N]]
  [Title] "title text" ← FontName 24pt
  [Text Box] "body text" ← FontName 11pt
  [Equation] "LaTeX formula"
  [Text Box] "text" ← contains equation: "formula"
  [Table] "TableName" ← {rows}x{cols}
  [Picture] "PictureName" ← alt="description"
  [Picture] "PictureName" ← ⚠ no alt text

Fields:

  • [Title] / [Text Box] — Shape type
  • "text" — Shape text content
  • ← FontName 11pt — First run's font and size
  • [Equation] — Math equation in LaTeX
  • [Table] — Table with name and dimensions
  • [Picture] — Picture with alt text status (⚠ = missing)

outline

Summary: file info, title per slide, shape/picture counts.

Output format:

File: {filename} | {N} slides
├── Slide 1: "Title text" - {N} text box(es), {N} picture(s)
├── Slide 2: "(untitled)" - {N} text box(es)
├── Slide 3: "Title text"

stats

Document statistics.

Output format:

Slides: {count}
Total shapes: {count}
Text boxes: {count}
Pictures: {count}
Slides without title: {count}
Pictures without alt text: {count}

Font usage:
  Arial: {count} occurrence(s)
  Calibri: {count} occurrence(s)

issues

Detects structure, format, and accessibility problems.

Output format:

Found {N} issue(s):

Structure Issues ({count}):
  [S1] /slide[3]: Slide has no title

Format Issues ({count}):
  [F1] /slide[1]/shape[2]: Inconsistent fonts in text box: Arial, Calibri
  [F2] /slide[2]: Picture "image1.png" is missing alt text (accessibility issue)

Issue types:

  • Structure — Missing titles
  • Format — Inconsistent fonts, missing alt text on pictures

html

Renders slides as an HTML preview and opens in the default browser. Supports shapes, text, images, tables, charts (inline SVG with 3D rendering), custom geometry, 3D effects, gradients, and slide navigation.

Behavior:

  • Without --json: writes HTML to a temp file and opens it in the browser. Outputs the file path to stdout.
  • With --json: outputs the raw HTML string to stdout (for piping to other tools).
  • Supports --start/--end to limit which slides are rendered.
# Open HTML preview in browser
officecli view slides.pptx html

# Preview slides 1-3 only
officecli view slides.pptx html --start 1 --end 3

# Get raw HTML for integration
officecli view slides.pptx html --json

Note: HTML preview is only available for .pptx files. Equations are rendered using KaTeX.

For a live preview that auto-refreshes on every change, use the watch command instead.

Examples

officecli view slides.pptx text
officecli view slides.pptx text --start 1 --end 5
officecli view slides.pptx annotated
officecli view slides.pptx outline
officecli view slides.pptx stats
officecli view slides.pptx issues
officecli view slides.pptx issues --type format
officecli view slides.pptx html
officecli view slides.pptx text --json

See Also


Based on OfficeCLI v1.0.17

Clone this wiki locally