Skip to content

command view ppt

zmworm edited this page Apr 29, 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 HTML. Supports shapes, text, images, tables, charts (inline SVG with 3D rendering), custom geometry, 3D effects, gradients, 3D models (via Three.js), zoom objects, and slide navigation.

Behavior:

  • Default: outputs raw HTML to stdout.
  • With --browser: writes HTML to a temp file, opens it in the default browser, and prints the temp file path.
  • Supports --start/--end to limit which slides are rendered.
# Output HTML to stdout (default)
officecli view slides.pptx html

# Open HTML preview in browser
officecli view slides.pptx html --browser

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

# Pipe HTML to a file
officecli view slides.pptx html > preview.html

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.

svg

Native SVG rendering of slides. Generates self-contained SVG (1920x1080) with no external dependencies.

Supports: shapes, connectors, pictures, tables, groups, gradients, shadows, glow, soft edges, text formatting (bold, italic, underline, strikethrough, bullets), math formulas (native MathML), charts, custom geometry, special shapes.

Behavior:

  • Default: outputs SVG to stdout.
  • With --browser: opens SVG in default browser.
  • Supports --start/--end to select slides.
# Output SVG to stdout
officecli view slides.pptx svg

# Open in browser
officecli view slides.pptx svg --browser

# Render specific slide
officecli view slides.pptx svg --start 3 --end 3

# Pipe to file
officecli view slides.pptx svg > slide.svg

Note: Math formulas are rendered as native MathML within SVG (no JavaScript or CDN required).

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 svg
officecli view slides.pptx text --json

See Also


Based on OfficeCLI v1.0.64

Clone this wiki locally