convert-contents

Convert content between formats like Markdown, HTML, PDF, and DOCX. Input content or files, specify output format, and provide complete file paths for saving. Ensure TeX Live installation for PDF conversions.

Instructions

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
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

Input Schema (JSON Schema)

{
  "allOf": [
    {
      "if": {
        "properties": {
          "output_format": {
            "enum": [
              "pdf",
              "docx",
              "rst",
              "latex",
              "epub"
            ]
          }
        }
      },
      "then": {
        "required": [
          "output_file"
        ]
      }
    }
  ],
  "oneOf": [
    {
      "required": [
        "contents"
      ]
    },
    {
      "required": [
        "input_file"
      ]
    }
  ],
  "properties": {
    "contents": {
      "description": "The content to be converted (required if input_file not provided)",
      "type": "string"
    },
    "input_file": {
      "description": "Complete path to input file including filename and extension (e.g., '/path/to/input.md')",
      "type": "string"
    },
    "input_format": {
      "default": "markdown",
      "description": "Source format of the content (defaults to markdown)",
      "enum": [
        "markdown",
        "html",
        "pdf",
        "docx",
        "rst",
        "latex",
        "epub",
        "txt"
      ],
      "type": "string"
    },
    "output_file": {
      "description": "Complete path where to save the output including filename and extension (required for pdf, docx, rst, latex, epub formats)",
      "type": "string"
    },
    "output_format": {
      "default": "markdown",
      "description": "Desired output format (defaults to markdown)",
      "enum": [
        "markdown",
        "html",
        "pdf",
        "docx",
        "rst",
        "latex",
        "epub",
        "txt"
      ],
      "type": "string"
    }
  },
  "type": "object"
}

mcp-pandoc