| name | combine-versions |
| description | Concatenate multiple transcript variants (raw, cleaned, structured, blog, summary, notes) into a single combined document — markdown with variant headers, or Typst-rendered PDF with page numbers and variant name in the footer. Use when the user asks to combine versions, merge transcript variants, or produce a single multi-version document. |
Combine transcript versions
Merge multiple variants of the same transcript into one document so the user can compare or archive them together.
Inputs
Detect available variants for a given source stem by checking for:
<stem>.raw.txt<stem>.cleaned.md<stem>.structured.md<stem>.blog.md<stem>.summary.md<stem>.notes.md
User may specify which to include; default is "all available".
Output formats
Markdown (default)
<stem>.combined.md — each variant under an H1 header with metadata:
# Transcript: <stem>
_Generated: YYYY-MM-DD_
_Source: <source audio filename>_
---
# Variant: Raw transcript
_Source file: <stem>.raw.txt_
_Produced by: transcribe-gemini-raw_
<content>
---
# Variant: Cleaned
_Source file: <stem>.cleaned.md_
_Produced by: clean-transcript_
<content>
---
# Variant: Structured
<content>
...
Typst → PDF
<stem>.combined.pdf — styled PDF via Typst.
Typst template:
#set document(title: "Transcript: <stem>")
#set page(
paper: "a4",
margin: (x: 2.5cm, y: 2cm),
header: [#h(1fr) <stem>],
footer: context [
#h(1fr)
Variant: #variant-name #h(2em) Page #counter(page).display()
],
)
#set text(font: "IBM Plex Sans", size: 10pt)
#show heading.where(level: 1): it => [
#pagebreak(weak: true)
#set text(size: 16pt, weight: "bold")
#it
]
// For each variant:
#let variant-name = "Raw transcript"
= Raw transcript
<content converted from md to typst>
#let variant-name = "Cleaned"
= Cleaned
...
Note: the variant-name state needs to be tracked per-section so the footer updates correctly — use Typst's state() or per-page context resolution.
Render:
typst compile <stem>.combined.typ <stem>.combined.pdf
Use IBM Plex Sans if available; otherwise fall back to the default Typst font.
Markdown → Typst conversion
For the PDF path, convert markdown content to Typst:
# H1 → = H1 (but we're already using = for variant headers; demote markdown H1 within content to ==)## H2 → ==**bold** → *bold**italic* → _italic_- list → - list (Typst supports markdown-like lists)- Code blocks →
raw() blocks
For complex markdown, consider piping through pandoc -t typst if available.
Parameters
--variants raw,cleaned,structured — pick subset--format md|pdf|both — output format(s)--output <path> — custom path
