Translate Markdown files

Translate READMEs, documentation, notes, and articles into more than 200 languages and download a Markdown file with its heading structure, tables, code, and link addresses preserved, using glossaries and several target languages in one job.

Upload your MD

Drag and drop your Markdown file

or click to browse files

MD

Markdown translation overview

From project READMEs and changelogs to documentation, knowledge-base notes, and blog posts, qlot translates each .md file as a separate document while preserving code and document structure. Choose from more than 200 source and target languages, translate into several languages at once, and use a glossary for your terminology.

Headings, paragraphs, table cells, footnote text, link text, and image alt text are translated, along with text between inline HTML tags. Code and link addresses stay as written, as do front matter and HTML blocks. Bold, italics, strikethrough, and links remain Markdown around the translated words.

When a translation cannot preserve a passage's Markdown, qlot keeps that passage in the source language to protect the document. All target languages of one upload share one job. If this affects more than 2% of the file's passages in any target language, the whole job fails with no charge for any language. Within the limit, a completed job is charged its full quoted price, including passages left in the source language.

Code stays unchanged

Code blocks and inline code stay exactly as written and are excluded from the credit calculation.

Document structure preserved

Headings, lists, quotes, and tables keep their structure while the text is translated, with bold, italics, strikethrough, and links retained.

More language choices

Choose from more than 200 source and target languages and translate one Markdown file into several target languages at once.

Upload Markdown files

Upload a .md file up to 12MB and 1 million lines, with each file translated as its own document.

Translation in minutes

A typical Markdown file is translated in minutes, depending on its length and the language pair.

Encoding handled automatically

qlot detects the encoding and retains it with the byte-order mark when the translated text can use that encoding, with UTF-8 as the fallback.

Translate your Markdown file in three simple steps

1

Upload your Markdown file

Drag and drop a .md file up to 12MB and 1 million lines, or select it from your device.

2

Choose your languages

Select the source language and one or more target languages, apply a glossary if needed, and start the translation on a paid plan.

3

Download your translated Markdown

Download the translated .md file with its document structure, code, and link addresses preserved.

What stays intact

Code blocks and inline codeCode blocks and inline code are kept exactly as written; neither is translated or billed.
Links and imagesLink text and image alt text are translated and count toward credits; link and image addresses, link titles, and link definitions stay unchanged and are not billed.
Front matter and HTMLYAML, TOML, and JSON front matter, HTML blocks, and HTML comments stay unchanged and are not billed; text between inline HTML tags is translated.
TablesTable cell text is translated while table pipes and alignment rows stay exactly as written.
Headings, lists, quotes, and footnotesText in headings, lists, quotes, and footnotes is translated; heading marks, list and quote markers, task-list boxes, and footnote markers and definition labels remain unchanged.
Text layout and line breaksParagraphs wrapped at a fixed width are rewrapped to their original width; one-sentence-per-line text keeps that layout, and other multiline paragraphs retain their line count where the translation allows it. For translations into Chinese, Japanese, Thai, Lao, Khmer, and Burmese, each paragraph is delivered on one line to avoid stray spaces in Markdown viewers.
Encoding and byte-order markUTF-8, UTF-16/UTF-32, and supported legacy code pages are detected automatically; the original encoding and byte-order mark are retained when the translated text can be written in that encoding, with UTF-8 used otherwise.
Limits and refusalsEmpty files, files over 12MB or 1 million lines, binary data, files with undetectable encoding, and files without translatable text are declined before any charge. Files whose text does not appear to match the chosen source language are also declined; the language check considers only translatable text, not code.

Keep your terminology consistent

Add your team's terms once and qlot applies them across your Markdown files, from product names to legal phrasing.

Glossary
  • 클롯qlot
  • 계약 당사자the Parties
  • 売上高revenue
  • 结算settlement
  • Rechnunginvoice
  • essai cliniqueclinical trial
  • desplieguedeployment

Frequently asked questions

Find answers to common questions about translating Markdown files with qlot.

Need more help?

Contact us
01Will translating my README preserve its code, links, and formatting?

Code blocks and inline code stay exactly as written. Headings, lists, quotes, and tables keep their structure, and bold, italics, strikethrough, and links remain Markdown around the translated words. Link text and image alt text are translated, while link and image addresses and link titles stay unchanged.

Links to headings inside the document are not rewritten. Translated headings get new anchors, so check and update links to those headings before publishing.

02Can I translate Markdown for GitHub and documentation sites?

qlot handles CommonMark plus tables, strikethrough, task lists, and footnotes, and recognizes GitHub alerts and Obsidian callouts. It preserves the syntax of Docusaurus and VitePress containers, MkDocs admonitions and tabs, Hugo shortcodes, Jekyll/Liquid tags, and Obsidian wiki links and embeds.

Front matter in YAML, TOML, or JSON stays unchanged, including its values. Wiki links and embeds are preserved in full, including their display text.

03Which parts of a Markdown file are not translated?

Code, link and image addresses, link titles, front matter, HTML blocks and comments, and link definitions stay unchanged. Footnote markers and definition labels stay as written, while footnote text is translated. Templates, shortcodes, math, emoji shortcodes, tags, and wiki links and embeds also stay unchanged, as do lines with no words, such as badge rows. These preserved elements are not billed.

If a translated passage cannot keep its Markdown intact, the original passage is retained. All target languages of one upload run as one job. If more than 2% of the file's passages require this fallback in any target language, the whole job fails and nothing is charged for any language. If the job completes within the limit, the full quoted price is charged, including passages left in the source language.

04How is Markdown translation billed, and which languages can I choose?

Credits are calculated from the text selected for translation, including link text and image alt text. Code, link and image addresses, link titles, markup, and front matter are excluded. A completed job within the 2% safeguard limit is charged its full quoted price, including passages left in the source language. The pricing page's credit guide can measure your file before translation.

More than 200 source and target languages are available, and one file can be translated into several target languages at once. Glossaries also apply to Markdown translation.

05Can I translate a Markdown file on the Preview plan?

Markdown translation requires a paid plan. The Preview plan does not support Markdown because previews are page images, and a Markdown file has no pages.

Explore more translation options

Keep the formatting and structure of your other business files intact across languages.

Translate PDF documentsTranslate PDF documents with layouts, fonts, tables, and images retained..pdfTranslate Word documentsPreserve headings, tables, images, and document styles..docxTranslate Excel workbooksRetain worksheet layouts, cells, formulas, and workbook structure..xlsxTranslate PowerPoint presentationsKeep slide layouts, text placement, images, and visual elements aligned..pptxTranslate Hancom documentsPreserve document structure, formatting, tables, and images..hwpxTranslate CSV filesTranslate CSV files with delimiters, encoding, numbers, and columns retained..csvTranslate PNG imagesTranslate PNG screenshots and diagrams with layout and transparency retained..pngTranslate JPG imagesTranslate JPG photos and scans with their colours and compression settings retained..jpgTranslate HEIC imagesTranslate iPhone HEIC photos with colour profile, dimensions, and format retained..heicTranslate HEIF imagesTranslate HEIF images with container, dimensions, colour profile, and transparency retained..heifTranslate WebP imagesTranslate WebP images with dimensions, transparency, and lossless or lossy encoding retained..webpTranslate TXT filesTranslate plain text with paragraphs and blank lines retained..txtTranslate SRT filesTranslate subtitle text with timestamps, cue numbers and cue order preserved..srtTranslate VTT filesTranslate caption text with cues, timestamps and web caption settings preserved..vtt
EPUBPreserve chapters, navigation, images, and reflowable book structure..epub
HTMLTranslate visible text while preserving tags, links, and markup..html
LaTeXTranslate prose while preserving commands, equations, and citations..tex
JSONTranslate string values while preserving keys and structure..json
XMLTranslate text content while preserving elements and attributes..xml
YAMLTranslate values while preserving keys, indentation, and structure..yaml
XLIFFTranslate segments while preserving inline tags and placeholders..xliff
InDesignTranslate text while preserving layout frames and styles..idml
FrameMakerTranslate technical content while preserving structure and references..mif
DITATranslate content while preserving topic structure and elements..dita
ODTPreserve styles, tables, images, and document structure..odt

Translate within the tools your team already uses

Use qlot with the messaging, collaboration, and cloud storage tools you already rely on. New integrations are rolling out to bring translated Markdown files directly into your existing workflow.

Webhooks and REST APIREST API and webhook access are available on request for teams that want to automate Markdown translation.
Get updates

Need to convert your files?

Convert Markdown files into the formats your workflow needs, before or after translation.

MD → HTMLPublish Markdown content on the webMD → PDFShare Markdown content as a polished document

Start translating Markdown files with qlot today.

AI-powered document translation optimized for clarity, accuracy, and precision.

Contact sales