mcp-pandoc
by vivekVells
convert-contents
Converts content between different formats. Transforms input content from any supported format into the specified output format.
🚨 CRITICAL REQUIREMENTS - PLEASE READ:
- PDF Conversion:
- You MUST install TeX Live BEFORE attempting PDF conversion:
- Ubuntu/Debian:
sudo apt-get install texlive-xetex - macOS:
brew install texlive - Windows: Install MiKTeX or TeX Live from https://miktex.org/ or https://tug.org/texlive/
- PDF conversion will FAIL without this installation
- File Paths - EXPLICIT REQUIREMENTS:
- When asked to save or convert to a file, you MUST provide:
- Complete directory path
- Filename
- File extension
- Example request: 'Write a story and save as PDF'
- You MUST specify: '/path/to/story.pdf' or 'C:\Documents\story.pdf'
- The tool will NOT automatically generate filenames or extensions
- When asked to save or convert to a file, you MUST provide:
- File Location After Conversion:
- After successful conversion, the tool will display the exact path where the file is saved
- Look for message: 'Content successfully converted and saved to: [file_path]'
- You can find your converted file at the specified location
- If no path is specified, files may be saved in system temp directory (/tmp/ on Unix systems)
- For better control, always provide explicit output file paths
Supported formats:
- Basic formats: txt, html, markdown
- Advanced formats (REQUIRE complete file paths): pdf, docx, rst, latex, epub
✅ CORRECT Usage Examples:
- 'Convert this text to HTML' (basic conversion)
- Tool will show converted content
- 'Save this text as PDF at /documents/story.pdf'
- Correct: specifies path + filename + extension
- Tool will show: 'Content successfully converted and saved to: /documents/story.pdf'
❌ INCORRECT Usage Examples:
- 'Save this as PDF in /documents/'
- Missing filename and extension
- 'Convert to PDF'
- Missing complete file path
When requesting conversion, ALWAYS specify:
- The content or input file
- The desired output format
- For advanced formats: complete output path + filename + extension Example: 'Convert this markdown to PDF and save as /path/to/output.pdf'
Note: After conversion, always check the success message for the exact file location.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| contents | No | The content to be converted (required if input_file not provided) | |
| input_file | No | Complete path to input file including filename and extension (e.g., '/path/to/input.md') | |
| input_format | No | Source format of the content (defaults to markdown) | markdown |
| output_file | No | Complete path where to save the output including filename and extension (required for pdf, docx, rst, latex, epub formats) | |
| output_format | No | Desired output format (defaults to markdown) | markdown |