md2doc - Markdown to DOCX

md2doc is a Model Context Protocol (MCP) server that converts Markdown text to DOCX format by delegating the actual conversion to an external service. It supports templates and multiple languages, making it easy to generate polished documents from Markdown content in automated workflows.

How to use

You use md2doc with any MCP-compatible client by running the MCP server in stdio mode and pointing your client to it. Start the server with the environment variable that provides your API key, then send Markdown content to be converted. The server will return a DOCX file path or data suitable for download.

How to install

Prerequisites you need before starting:

• Install the runtime you will use to run MCP servers (in this case, the runtime is provided by the MCP client tooling). The server is launched process-side via a simple command.

md2doc configuration and run instructions

{
  "mcpServers": {
    "md2doc": {
      "command": "uvx",
      "args": ["md2doc"],
      "env": {
        "DEEP_SHARE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Notes and tips

• Ensure the API key you provide with DEEP_SHARE_API_KEY is kept secure and not checked into source control. Rotate keys as needed and use least-privilege access where possible.

• md2doc can be used with templates to customize the resulting DOCX file. Language options influence available templates and localization.

• When you automate conversions, you can pass Markdown content and a target template name to control the output style. Use the available tools to list templates for a chosen language and to perform the conversion.

Troubleshooting

If the server fails to start, verify that the uvx runtime is installed and that the environment variable is readable by the process. Check for network issues if the external conversion service is used and ensure your API key is valid.

If conversions return errors, confirm you are sending valid Markdown and that the selected template exists for the chosen language.

Examples of common workflows

• Convert Markdown to DOCX using the configured md2doc MCP server and download the resulting file to your local machine or a downstream workflow. - Integrate the server into a CI/CD pipeline to automatically generate documents from changelogs or design notes.

Available tools

convert_markdown_to_docx

Convert Markdown text to a DOCX file using the configured md2doc MCP server.

list_templates

Retrieve available templates for a given language and use them to tailor the generated DOCX output.