AI Markdown Article Translator

Translate full Markdown articles with AI while preserving headings, tables, links, images, and code blocks for direct publication

Paste a Markdown article or upload a .md file, choose the target language, and optionally add a glossary to keep brand names and technical terms stable. The tool protects code fences, inline code, URLs, and optional anchor slugs before translation, then restores them into the final publish-ready Markdown.

How to use it:

  • Markdown Input / Markdown File: provide the article source
  • Source Language: use auto-detect or force a source language if the article mixes scripts
  • Target Language: pick the output language for publication
  • Glossary: add one term per line in forms like React => React or edge function => Edge Function
  • Preserve Anchor Slugs: keep in-page anchor links such as (#api-reference) unchanged

What it preserves:

  • fenced code blocks and inline code
  • Markdown headings, lists, tables, emphasis, and blockquotes
  • image and link URLs
  • optional anchor-style slugs for internal table-of-contents links

Example Results

1 examples

Translate an engineering release note into English without breaking code blocks

Keep fenced code, inline commands, table formatting, and internal links intact while translating the prose around them.

# Release Notes

Welcome to the new version.

| Item | Status |
| --- | --- |
| API | live |

Run `npm run build`.

[See API section](#api-reference)
View input parameters
{ "markdownInput": "# 发布说明\n\n欢迎使用新版本。\n\n| 项目 | 状态 |\n| --- | --- |\n| API | 已上线 |\n\n请运行 `npm run build`。\n\n[查看 API 章节](#api-reference)", "markdownFile": "", "sourceLanguage": "auto", "targetLanguage": "english", "glossary": "已上线 => live\n发布说明 => Release Notes", "preserveAnchorSlugs": true }

Click to upload file or drag and drop file here

Maximum file size: 5MB Supported formats: text/markdown, text/plain, .md, .markdown

Key Facts

Category
Text & Writing
Input Types
textarea, file, select, checkbox
Output Type
stream
Sample Coverage
4
API Ready
Yes

Overview

Translate full Markdown articles using AI without breaking your formatting. This tool preserves code blocks, tables, images, and links while translating the prose, allowing you to localize technical documentation and blog posts for direct publication.

When to Use

  • •When localizing technical documentation or API references that contain extensive code blocks and tables.
  • •When translating blog posts or tutorials where brand names and technical terms must remain consistent using a glossary.
  • •When migrating Markdown files to a new language version of a website while keeping internal anchor links intact.

How It Works

  • •Paste your Markdown text or upload a .md file directly into the tool.
  • •Select your target language and optionally define a glossary to lock specific terms (e.g., 'Edge Function => Edge Function').
  • •Enable 'Preserve Anchor Slugs' if you want to keep internal table-of-contents links unchanged.
  • •The AI translates the prose while strictly protecting fenced code, inline code, URLs, and Markdown syntax, outputting a publish-ready file.

Use Cases

Translating open-source project README files into multiple languages to reach a broader developer community.
Localizing software release notes while maintaining the exact formatting of commands and status tables.
Converting technical blog posts into a target language without manually extracting and re-inserting code snippets.

Examples

1. Translating Engineering Release Notes

Technical Writer
Background
A technical writer needs to publish the latest software release notes in English, but the original draft is in Chinese.
Problem
Translating the document manually risks breaking the Markdown tables, inline npm commands, and internal anchor links.
How to Use
Paste the Chinese Markdown into the input, set Target Language to 'English', and add glossary terms for specific product names.
Example Config
Target Language: English
Glossary: 已上线 => live
Preserve Anchor Slugs: Checked
Outcome
The prose is translated to English, but the status table structure, `npm run build` command, and `(#api-reference)` link remain perfectly intact.

2. Localizing API Documentation

Developer Advocate
Background
A developer advocate is translating a Spanish API integration guide into Japanese to support a new regional launch.
Problem
Standard translation tools corrupt the JSON payloads inside the code blocks and translate API endpoint URLs.
How to Use
Upload the `api-guide.md` file, select 'Japanese' as the target language, and run the translation.
Example Config
Target Language: Japanese
Source Language: Spanish
Outcome
The explanatory text is translated into natural Japanese, while all JSON code blocks, endpoint URLs, and authentication headers are preserved exactly as written.

Try with Samples

markdown, image, text
Markdown Link Extractor Samples
Sample Markdown documents with various link types for testing the Markdown Link Extractor tool
title token markdown
markdown, text
Markdown Samples
Markdown format examples from simple to complex document structures
title token markdown
markdown, text
Markdown Slide Deck Samples
Remark/Marp style Markdown slide decks for testing PDF export layouts
title token markdown
markdown, text
PDF Samples
Generated PDF samples from tools dated 2026-02-01 to 2026-02-10
preferred input family markdown,text
markdown, text

Related Hubs

Markdown Tools
Explore 10 markdown tools for utility workflows and compare closely related utilities quickly.
Image Convert Tools
Explore 100 image tools for convert workflows and compare closely related utilities quickly.
Text Convert Tools
Explore 80 text tools for convert workflows and compare closely related utilities quickly.
Image Tools
Explore 40 image tools for utility workflows and compare closely related utilities quickly.

FAQ

Does this tool translate the code inside code blocks?

No, fenced code blocks and inline code are strictly preserved and will not be translated.

How do I use the glossary feature?

Enter one translation rule per line in the format 'Source Term => Target Term' to ensure consistent terminology.

Can I upload a Markdown file instead of pasting text?

Yes, you can upload a .md or .markdown file up to 5MB in size.

What does 'Preserve Anchor Slugs' do?

It prevents the AI from translating internal anchor links, such as `(#api-reference)`, ensuring your table of contents still works.

Will my tables and images break during translation?

No, the tool is designed to protect Markdown structures, including tables, image URLs, and link formatting.

API Documentation

Request Endpoint

POST /en/api/tools/ai-markdown-article-translator

Request Parameters

Parameter Name Type Required Description
markdownInput textarea No -
markdownFile file (Upload required) No -
sourceLanguage select No -
targetLanguage select No -
glossary textarea No -
preserveAnchorSlugs checkbox No -

File type parameters need to be uploaded first via POST /upload/ai-markdown-article-translator to get filePath, then pass filePath to the corresponding file field.

Response Format

data: {"chunk": "data: processed content 1", "type": "stream"}


data: {"chunk": "data: processed content 2", "type": "stream"}


data: {"type": "done"}
Stream: Stream

AI MCP Documentation

Add this tool to your MCP server configuration: 

{
  "mcpServers": {
    "elysiatools-ai-markdown-article-translator": {
      "name": "ai-markdown-article-translator",
      "description": "Translate full Markdown articles with AI while preserving headings, tables, links, images, and code blocks for direct publication",
      "baseUrl": "https://elysiatools.com/mcp/sse?toolId=ai-markdown-article-translator",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

You can chain multiple tools, e.g.: `https://elysiatools.com/mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp`, max 20 tools.

Supports URL file links or Base64 encoding for file parameters.

If you encounter any issues, please contact us at [email protected]