{
  "schemaVersion": "1.0",
  "item": {
    "slug": "pandoc-convert-openclaw",
    "name": "Pandoc Convert",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/TheJorgeSchmidt/pandoc-convert-openclaw",
    "canonicalUrl": "https://clawhub.ai/TheJorgeSchmidt/pandoc-convert-openclaw",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/pandoc-convert-openclaw",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=pandoc-convert-openclaw",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/pandoc-convert-openclaw"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/pandoc-convert-openclaw",
    "agentPageUrl": "https://openagent3.xyz/skills/pandoc-convert-openclaw/agent",
    "manifestUrl": "https://openagent3.xyz/skills/pandoc-convert-openclaw/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/pandoc-convert-openclaw/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "📄 Pandoc Convert (Integrated)",
        "body": "Universal document converter combining unified Python tools with modular bash utilities.\n\nThe pandoc-convert skill provides intelligent workflows for converting documents between 40+ formats using pandoc. This integrated version combines:\n\nUnified Python converter (convert.py) - Single powerful tool for most conversions\nModular bash utilities (batch_convert.sh, validate.sh) - Specialized workflows\nComprehensive templates - Both LaTeX academic and modern CSS styles\nProfessional documentation - Complete guides, troubleshooting, and references"
      },
      {
        "title": "✨ Key Features",
        "body": "40+ Format Support: Markdown, Word, PDF, HTML, LaTeX, EPUB, RST, AsciiDoc, Org-mode, and more\nDual Toolset: Python for smart conversions + bash for validation/batch processing\nProfessional Templates: 12 templates covering academic, business, and web use cases\nComprehensive Documentation: Format guides, troubleshooting, templates, and quick reference\nSmart Defaults: Optimized settings for each conversion path\nMetadata Preservation: Keep titles, authors, dates across formats\nError Recovery: Validation and helpful error messages"
      },
      {
        "title": "Required",
        "body": "pandoc (v2.19+ recommended)\nPython 3.8+ (for convert.py helper)"
      },
      {
        "title": "Optional (for extended formats)",
        "body": "LaTeX (TeX Live, MiKTeX) - Required for PDF output\nwkhtmltopdf - Alternative HTML to PDF converter\nlibrsvg - SVG support\nepubcheck - EPUB validation\n\nSee INSTALL.md for detailed installation instructions per platform."
      },
      {
        "title": "Using Python Helper (Recommended)",
        "body": "# Single file conversion\npython scripts/convert.py input.md output.pdf\n\n# With custom template\npython scripts/convert.py report.md report.pdf --template business --toc\n\n# Batch convert\npython scripts/convert.py --batch *.md --format pdf --output-dir ./pdfs"
      },
      {
        "title": "Using Bash Utilities",
        "body": "# Batch convert with validation\n./scripts/batch_convert.sh input/*.md pdf output/\n\n# Validate output\n./scripts/validate.sh output/document.pdf\n./scripts/validate.sh output/book.epub"
      },
      {
        "title": "Direct Pandoc",
        "body": "# Markdown → PDF\npandoc input.md -o output.pdf\n\n# Markdown → Word\npandoc input.md -o output.docx\n\n# Word → Markdown\npandoc input.docx -o output.md --extract-media=./media"
      },
      {
        "title": "🎯 Common Workflows",
        "body": "See references/conversion-guides.md for detailed step-by-step guides:\n\nMarkdown → Professional PDF (business reports, academic papers)\nWord → Markdown (version control friendly)\nMarkdown → EPUB (eBooks with validation)\nMulti-file → Single PDF (book compilation)\nMarkdown → HTML5 (standalone with CSS)"
      },
      {
        "title": "LaTeX Templates (Academic/Professional)",
        "body": "academic-paper.tex - Manuscript style\nbusiness-letter.tex - Professional correspondence\ntechnical-report.tex - Technical documentation\nresume.tex - CV/resume formatting\nprofessional.tex - General-purpose professional\nreport-template.tex - Report structure"
      },
      {
        "title": "CSS Templates (Web/Modern)",
        "body": "github.css - GitHub markdown style\nblog-style.css - Clean blog format\nepub-style.css - eBook styling\npresentation.html - HTML presentations\nebook.css - Enhanced eBook layout"
      },
      {
        "title": "Reference Documents",
        "body": "reference-styles.docx - Word style reference\n\nAll templates in templates/ directory."
      },
      {
        "title": "convert.py (Python)",
        "body": "Unified conversion tool with smart defaults:\n\npython scripts/convert.py [OPTIONS] INPUT OUTPUT\n\nOptions:\n  --format FORMAT       Force output format\n  --template TEMPLATE   Use named template\n  --toc                 Include table of contents\n  --number-sections     Number headings\n  --title TITLE         Document title\n  --author AUTHOR       Document author\n  --batch               Batch mode\n  --validate            Validate output\n  --verbose             Detailed output"
      },
      {
        "title": "batch_convert.sh (Bash)",
        "body": "Batch processing with progress tracking:\n\n./scripts/batch_convert.sh INPUT_DIR FORMAT OUTPUT_DIR [OPTIONS]\n\n# Example\n./scripts/batch_convert.sh ./docs/ pdf ./output/ --toc --number-sections"
      },
      {
        "title": "validate.sh (Bash)",
        "body": "Post-conversion validation:\n\n./scripts/validate.sh FILE\n\n# Validates:\n# - PDF structure and readability\n# - EPUB spec compliance (requires epubcheck)\n# - HTML validity\n# - File integrity"
      },
      {
        "title": "Input Formats",
        "body": "Markdown: markdown, gfm, markdown_mmd\nWord: docx, odt, rtf\nWeb: html, html5\nLaTeX: latex, tex\nPlain Text: txt, rst, textile, asciidoc\nAcademic: jats, docbook\nPresentation: pptx\neBooks: epub\nOther: json, csv, org, mediawiki, man"
      },
      {
        "title": "Output Formats",
        "body": "All input formats plus: PDF, EPUB, RevealJS, Beamer\n\nComplete format matrix: references/format-matrix.md"
      },
      {
        "title": "🗂️ Directory Structure",
        "body": "pandoc-convert-integrated/\n├── SKILL.md              # This file\n├── INSTALL.md            # Detailed installation guide\n├── README.md             # Quick start guide\n├── scripts/\n│   ├── convert.py        # Unified Python converter\n│   ├── batch_convert.sh  # Bash batch processor\n│   └── validate.sh       # Validation utility\n├── templates/\n│   ├── *.tex             # LaTeX templates (6)\n│   ├── *.css             # CSS templates (3)\n│   ├── *.html            # HTML templates (1)\n│   └── *.docx            # Word reference (1)\n└── references/\n    ├── format-guide.md         # Format details\n    ├── format-matrix.md        # Compatibility matrix\n    ├── conversion-guides.md    # Step-by-step guides\n    ├── format-support.md       # Supported features\n    ├── quick-reference.md      # Cheat sheet\n    ├── templates.md            # Template documentation\n    └── troubleshooting.md      # Problem solving"
      },
      {
        "title": "Common Issues",
        "body": "\"pandoc: command not found\" → Install pandoc (see INSTALL.md)\n\"pdflatex not found\" → Install LaTeX distribution\nUnicode broken in PDF → Use --pdf-engine=xelatex\nImages missing → Check paths and use --resource-path\nEPUB validation fails → Run epubcheck for details\n\nSee references/troubleshooting.md for comprehensive solutions."
      },
      {
        "title": "📖 References",
        "body": "INSTALL.md - Platform-specific installation\nreferences/format-guide.md - Format capabilities and limitations\nreferences/conversion-guides.md - Step-by-step workflows\nreferences/quick-reference.md - One-page cheat sheet\nreferences/templates.md - Template usage and customization\nreferences/troubleshooting.md - Extended problem solving"
      },
      {
        "title": "🎯 Best Practices",
        "body": "Use YAML frontmatter for metadata (title, author, date)\nValidate outputs before sharing (especially EPUB/PDF)\nVersion control source (Markdown), not outputs\nTest templates first before batch processing\nBack up before batch operations"
      },
      {
        "title": "🚀 Performance",
        "body": "Use batch_convert.sh for parallel processing of multiple files\nCache templates in ~/.pandoc/templates/\nUse incremental builds (only reconvert changed files)\nFor very large docs (>10MB), increase memory limits"
      },
      {
        "title": "📜 License",
        "body": "This skill is part of OpenClaw. Pandoc itself is GPL-licensed.\n\nQuick Start: python scripts/convert.py input.md output.pdf\nBatch Convert: ./scripts/batch_convert.sh *.md pdf ./output/\nValidate: ./scripts/validate.sh output.pdf\nHelp: See README.md and references/ directory"
      }
    ],
    "body": "📄 Pandoc Convert (Integrated)\n\nUniversal document converter combining unified Python tools with modular bash utilities.\n\nThe pandoc-convert skill provides intelligent workflows for converting documents between 40+ formats using pandoc. This integrated version combines:\n\nUnified Python converter (convert.py) - Single powerful tool for most conversions\nModular bash utilities (batch_convert.sh, validate.sh) - Specialized workflows\nComprehensive templates - Both LaTeX academic and modern CSS styles\nProfessional documentation - Complete guides, troubleshooting, and references\n✨ Key Features\n40+ Format Support: Markdown, Word, PDF, HTML, LaTeX, EPUB, RST, AsciiDoc, Org-mode, and more\nDual Toolset: Python for smart conversions + bash for validation/batch processing\nProfessional Templates: 12 templates covering academic, business, and web use cases\nComprehensive Documentation: Format guides, troubleshooting, templates, and quick reference\nSmart Defaults: Optimized settings for each conversion path\nMetadata Preservation: Keep titles, authors, dates across formats\nError Recovery: Validation and helpful error messages\n🔧 Prerequisites\nRequired\npandoc (v2.19+ recommended)\nPython 3.8+ (for convert.py helper)\nOptional (for extended formats)\nLaTeX (TeX Live, MiKTeX) - Required for PDF output\nwkhtmltopdf - Alternative HTML to PDF converter\nlibrsvg - SVG support\nepubcheck - EPUB validation\n\nSee INSTALL.md for detailed installation instructions per platform.\n\n📚 Quick Start\nUsing Python Helper (Recommended)\n# Single file conversion\npython scripts/convert.py input.md output.pdf\n\n# With custom template\npython scripts/convert.py report.md report.pdf --template business --toc\n\n# Batch convert\npython scripts/convert.py --batch *.md --format pdf --output-dir ./pdfs\n\nUsing Bash Utilities\n# Batch convert with validation\n./scripts/batch_convert.sh input/*.md pdf output/\n\n# Validate output\n./scripts/validate.sh output/document.pdf\n./scripts/validate.sh output/book.epub\n\nDirect Pandoc\n# Markdown → PDF\npandoc input.md -o output.pdf\n\n# Markdown → Word\npandoc input.md -o output.docx\n\n# Word → Markdown\npandoc input.docx -o output.md --extract-media=./media\n\n🎯 Common Workflows\n\nSee references/conversion-guides.md for detailed step-by-step guides:\n\nMarkdown → Professional PDF (business reports, academic papers)\nWord → Markdown (version control friendly)\nMarkdown → EPUB (eBooks with validation)\nMulti-file → Single PDF (book compilation)\nMarkdown → HTML5 (standalone with CSS)\n🎨 Templates\nLaTeX Templates (Academic/Professional)\nacademic-paper.tex - Manuscript style\nbusiness-letter.tex - Professional correspondence\ntechnical-report.tex - Technical documentation\nresume.tex - CV/resume formatting\nprofessional.tex - General-purpose professional\nreport-template.tex - Report structure\nCSS Templates (Web/Modern)\ngithub.css - GitHub markdown style\nblog-style.css - Clean blog format\nepub-style.css - eBook styling\npresentation.html - HTML presentations\nebook.css - Enhanced eBook layout\nReference Documents\nreference-styles.docx - Word style reference\n\nAll templates in templates/ directory.\n\n🔧 Tool Reference\nconvert.py (Python)\n\nUnified conversion tool with smart defaults:\n\npython scripts/convert.py [OPTIONS] INPUT OUTPUT\n\nOptions:\n  --format FORMAT       Force output format\n  --template TEMPLATE   Use named template\n  --toc                 Include table of contents\n  --number-sections     Number headings\n  --title TITLE         Document title\n  --author AUTHOR       Document author\n  --batch               Batch mode\n  --validate            Validate output\n  --verbose             Detailed output\n\nbatch_convert.sh (Bash)\n\nBatch processing with progress tracking:\n\n./scripts/batch_convert.sh INPUT_DIR FORMAT OUTPUT_DIR [OPTIONS]\n\n# Example\n./scripts/batch_convert.sh ./docs/ pdf ./output/ --toc --number-sections\n\nvalidate.sh (Bash)\n\nPost-conversion validation:\n\n./scripts/validate.sh FILE\n\n# Validates:\n# - PDF structure and readability\n# - EPUB spec compliance (requires epubcheck)\n# - HTML validity\n# - File integrity\n\n📊 Format Support\nInput Formats\n\nMarkdown: markdown, gfm, markdown_mmd Word: docx, odt, rtf Web: html, html5 LaTeX: latex, tex Plain Text: txt, rst, textile, asciidoc Academic: jats, docbook Presentation: pptx eBooks: epub Other: json, csv, org, mediawiki, man\n\nOutput Formats\n\nAll input formats plus: PDF, EPUB, RevealJS, Beamer\n\nComplete format matrix: references/format-matrix.md\n\n🗂️ Directory Structure\npandoc-convert-integrated/\n├── SKILL.md              # This file\n├── INSTALL.md            # Detailed installation guide\n├── README.md             # Quick start guide\n├── scripts/\n│   ├── convert.py        # Unified Python converter\n│   ├── batch_convert.sh  # Bash batch processor\n│   └── validate.sh       # Validation utility\n├── templates/\n│   ├── *.tex             # LaTeX templates (6)\n│   ├── *.css             # CSS templates (3)\n│   ├── *.html            # HTML templates (1)\n│   └── *.docx            # Word reference (1)\n└── references/\n    ├── format-guide.md         # Format details\n    ├── format-matrix.md        # Compatibility matrix\n    ├── conversion-guides.md    # Step-by-step guides\n    ├── format-support.md       # Supported features\n    ├── quick-reference.md      # Cheat sheet\n    ├── templates.md            # Template documentation\n    └── troubleshooting.md      # Problem solving\n\n🐛 Troubleshooting\nCommon Issues\n\"pandoc: command not found\" → Install pandoc (see INSTALL.md)\n\"pdflatex not found\" → Install LaTeX distribution\nUnicode broken in PDF → Use --pdf-engine=xelatex\nImages missing → Check paths and use --resource-path\nEPUB validation fails → Run epubcheck for details\n\nSee references/troubleshooting.md for comprehensive solutions.\n\n📖 References\nINSTALL.md - Platform-specific installation\nreferences/format-guide.md - Format capabilities and limitations\nreferences/conversion-guides.md - Step-by-step workflows\nreferences/quick-reference.md - One-page cheat sheet\nreferences/templates.md - Template usage and customization\nreferences/troubleshooting.md - Extended problem solving\n🎯 Best Practices\nUse YAML frontmatter for metadata (title, author, date)\nValidate outputs before sharing (especially EPUB/PDF)\nVersion control source (Markdown), not outputs\nTest templates first before batch processing\nBack up before batch operations\n🚀 Performance\nUse batch_convert.sh for parallel processing of multiple files\nCache templates in ~/.pandoc/templates/\nUse incremental builds (only reconvert changed files)\nFor very large docs (>10MB), increase memory limits\n📜 License\n\nThis skill is part of OpenClaw. Pandoc itself is GPL-licensed.\n\nQuick Start: python scripts/convert.py input.md output.pdf\nBatch Convert: ./scripts/batch_convert.sh *.md pdf ./output/\nValidate: ./scripts/validate.sh output.pdf\nHelp: See README.md and references/ directory"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/TheJorgeSchmidt/pandoc-convert-openclaw",
    "publisherUrl": "https://clawhub.ai/TheJorgeSchmidt/pandoc-convert-openclaw",
    "owner": "TheJorgeSchmidt",
    "version": "0.1.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/pandoc-convert-openclaw",
    "downloadUrl": "https://openagent3.xyz/downloads/pandoc-convert-openclaw",
    "agentUrl": "https://openagent3.xyz/skills/pandoc-convert-openclaw/agent",
    "manifestUrl": "https://openagent3.xyz/skills/pandoc-convert-openclaw/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/pandoc-convert-openclaw/agent.md"
  }
}