pandoc-convert-openclaw_skill

Overview

This skill converts documents between 40+ formats using the pandoc CLI with a unified Python helper and modular bash utilities. It delivers smart defaults, professional LaTeX and CSS templates, and validation tooling to preserve metadata and produce publication-ready output. The toolset supports single-file, batch, and validated workflows for common publishing needs.

How this skill works

A Python wrapper (convert.py) orchestrates pandoc calls with sensible options and template selection, handling metadata, table of contents, and output format specifics. Supplementary bash scripts enable batch conversion, progress tracking, and post-conversion validation (PDF, EPUB, HTML). Templates and format guides ensure consistent styling and compatibility, while optional engines (LaTeX, wkhtmltopdf) cover format-specific rendering.

When to use it

• Produce professional PDFs, EPUBs, Word docs, or HTML from Markdown or other source formats
• Convert legacy Word or RTF documents to Markdown for version control
• Batch-convert large documentation sets or books into a single output
• Validate EPUB or PDF outputs before publication or distribution
• Apply consistent templates across reports, resumes, or academic papers

Best practices

• Keep source (Markdown) under version control and treat outputs as build artifacts
• Use YAML frontmatter for metadata to ensure title/author/date carry through
• Test templates on a single file before running batch jobs
• Validate EPUB/PDF with the provided validate.sh script (use epubcheck for EPUB)
• Cache frequently used templates in ~/.pandoc/templates/ and use incremental builds

Example use cases

• Convert a project README (Markdown) to a styled PDF report with a business template
• Transform a collection of Markdown chapters into a single PDF book with numbered sections
• Migrate Word meeting notes to Markdown for Git-based collaboration
• Generate an EPUB eBook from Markdown and run epubcheck validation
• Batch-render documentation directory to HTML5 with custom CSS for a docs site