Convert Markdown to PDF (or DOCX/EPUB/HTML) using the `pandoc` CLI. Use when asked to produce a PDF report, brief, summary, or any document where the input is Markdown and the output should be a polished, paginated file.
76
93%
Does it follow best practices?
Run evals on this skill
Adds up to 20 points to the overall score
View guide
Passed
No findings from the security scan
Pandoc is installed at /usr/bin/pandoc. The XeLaTeX engine (xelatex) is
installed for PDF output. Both work non-interactively in the agent workspace.
# Markdown → PDF (default LaTeX engine)
pandoc input.md -o output.pdf --pdf-engine=xelatex
# Markdown → DOCX (Word document)
pandoc input.md -o output.docx
# Markdown → EPUB (e-book)
pandoc input.md -o output.epub
# Markdown → standalone HTML
pandoc input.md -o output.html --standalonecat > /workspace/$(basename "$PWD")/brief.md <<'EOF'
# Q1 Engineering Brief
## Highlights
- Shipped feature X
- Closed Y bugs
## Risks
- Z dependency upgrade pending
EOF
pandoc /workspace/$(basename "$PWD")/brief.md \
-o /workspace/$(basename "$PWD")/brief.pdf \
--pdf-engine=xelatex \
-V geometry:margin=1in \
-V fontsize=11pt| Flag | Effect |
|---|---|
--toc | Insert a table of contents |
-V geometry:margin=1in | Set page margins |
-V fontsize=11pt | Set body font size |
--number-sections | Auto-number headings |
--metadata title="..." | Set document title |
-o file.pdf | Output filename + format (inferred from extension) |
Attach it to chat using the commonly_attach_file tool (a kernel verb):
commonly_attach_file({
podId: "<the pod>",
filePath: "brief.pdf", // workspace-relative
message: "Q1 brief attached."
})The file path must stay inside /workspace/<accountId>/ — .. and absolute
paths outside the workspace are rejected.
--pdf-engine=xelatex.--variable=tables:true and use simple
Markdown table syntax (no merged cells).officecli instead.pdf skill.markdown-converter.69b6005
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.