Synopsis

struktur parse --input <file> [options]
struktur parse --stdin [options]

Description

Converts a file or stdin to Artifact JSON. Use this to:

See how Struktur will represent your document before running extraction

Pre-process files and cache the artifact JSON for repeated extraction

Debug parser output when configuring a custom parser

Pipe artifacts into extract for decoupled workflows

Prop

Type

Prop

Type

Prop

Type

Prop

Type

--parser <pkg> flag — bypasses all config
Parser configured for the detected MIME type (struktur config parsers add ...)
Built-in parser for the MIME type
Error: no parser found — suggests struktur config parsers add

MIME type	Behavior
`application/pdf`	Per-page text via `pdf-parse`. Add `--images` for embedded images, `--screenshots` for page renders.
`text/*`	Split on double newlines into content slices.
`image/*`	Single-content artifact with the image as a media item.
`application/json`	If it validates as `SerializedArtifact[]`, passed through unchanged.

struktur parse --input document.pdf

struktur parse --input slides.pdf --images --screenshots --output artifact.json

struktur parse --input data.xlsx --parser @myorg/xlsx-parser

struktur parse --input doc.pdf --images | \
  struktur extract --artifact-file - --fields "title, author" --model openai/gpt-4o-mini

struktur parse --input doc.pdf | struktur utils artifact-viewer --stdin > viewer.html
open viewer.html