pandoc

scriptabledocs / content
$ brew install pandoc
Summary

Document conversion, markdown, and publishing from the terminal.

  • pandoc fits git & github well, especially for document conversion, markdown, and publishing from the terminal.
  • 39,721 homebrew installs (30d).
  • Easy to automate.
  • Good fit for coding-agent workflows and repeatable scripts.
  • Output is mostly text-first, so verify results before scripting around it.
github-pandoc-SKILL.md

Pandoc guide

Document conversion, markdown, and publishing from the terminal. Built by Pandoc.

Open CLI packages the install path, verify step, and safe-start workflow so this tool can move from “interesting CLI” to something you can actually use. It also integrates with skills.sh so each CLI comes with the right companion skills, not just a binary and a docs link.

When to apply

  • document conversion, markdown, and publishing from the terminal.
  • You need docs and content in both local dev and CI.
  • You need document conversion.
  • You need markdown.
  • You need publishing.

Quick reference

Installbrew install pandoc
Verifypandoc --version
First real commandpandoc README.md -o README.html

Open CLI × skills.sh

Open CLI integrates pandoc with the right skills.sh companions so you get the tool and the workflow together.

Technical Writing

Recommended pairing

Open CLI recommends this skills.sh skill because it fits docs / content workflows. Document commands, outputs, and workflows in a way other people can reuse.

View on skills.sh
$ npx skills add https://github.com/supercent-io/skills-template --skill technical-writing
Starter prompt

Use pandoc together with the Technical Writing skills.sh skill. Start with safe inspection commands, summarize what you find, and ask before any step with side effects.

Why this tool

  • pandoc fits git & github well, especially for document conversion, markdown, and publishing from the terminal.
  • 39,721 homebrew installs (30d).
  • Easy to automate.

Watch-outs

  • Output is mostly plain text.

Example workflow

1. pandoc README.md -o README.html

Safe start

Step 1

Install pandoc.

Step 2

Run `pandoc --version` first.

Step 3

Start with `pandoc README.md -o README.html`.

Step 4

Install the CLI and make sure it is on your PATH.

Alternatives worth considering