// exporting
Exporting
One session, every format. Reach for rekord export with a --to target.
Formats at a glance
| --to | output | use it for |
|---|---|---|
| cast | session.cast | faithful, replayable recording |
| markdown | demo.md | READMEs, tutorials, docs |
| json | session.json | pipelines & tooling |
| script | replay.sh | a runnable shell script |
| gif | demo.gif | embeds & chat |
| mp4 | demo.mp4 | release videos |
Markdown
$ rekord export monocron-demo --to markdown -o demo.md ✓ wrote demo.md · 5 commands · 42 lines
GIF & video
Render the session to an animated GIF or MP4, complete with recorded timing. MP4 takes a --size preset (720p or 1080p).
$ rekord export monocron-demo --to gif -o docs/demo.gif ✓ rendered docs/demo.gif · 1.8 MB · 12s
▋ note
GIF/MP4 export needs agg installed (and ffmpeg for MP4). Run rekord doctor to check what's available.
Redacting on export
Pass --redact to strip secrets from any export, or --no-redact to override a config default. Your recorded source files are never modified — redaction only touches the generated output.
$ rekord export monocron-demo --to markdown --redact ✓ wrote demo.md · 2 secrets redacted