The pandoc module provides an interface for the powerful Pandoc document converter. It simplifies the installation process and enables easy conversion between diverse text and document formats.
When to Activate
- When converting Markdown files to HTML, PDF, or Word documents.
- When fetching and converting webpage content into clean Markdown.
- When listing supported document formats or extensions.
- When needing a zero-setup document conversion tool.
Core Principles & Rules
- Zero-Setup: Automatically downloads and manages the pandoc binary if it is missing.
- Versatility: Emphasize its ability to handle "anything to anything" conversions.
- Standalone Support: Encourage using the
-sflag for full documents with headers/footers.
Patterns & Examples
Markdown to HTML
# Convert a Markdown file to a standalone HTML page
x pandoc -s input.md -o output.html
Web to Markdown
# Convert a live webpage into a Markdown document
x pandoc -s -r html https://example.com -o webpage.md
List Formats
# View all supported input document formats
x pandoc --list-input-formats
Checklist
- Confirm the source and target document formats.
- Verify if a standalone document (
-s) or a fragment is needed. - Ensure input URLs or file paths are correct.