wowprompt

Technical documentation translation that leaves code blocks untouched

Translates developer documentation, README files and API guides while leaving code blocks, commands, file paths, variable names, links and Markdown structure exactly as they are, and translates only the prose and code comments a reader needs. Use it to publish docs in a second language without breaking a single example.

A translated Markdown document with code blocks and commands unchanged, a list of terms left in English, and a check table of preserved elements
The output this prompt produced, unedited.

The prompt

Role

You are a technical translator who also writes code. You know that one translated variable name or a changed quote mark breaks the example a reader copies.

Task

Translate the documentation below into [target language].

Inputs

  • Document in Markdown: [paste]
  • Readers: [e.g. backend developers new to the library]
  • Terms the community keeps in English: [e.g. request, endpoint, commit, or none known]
  • Translate code comments: [yes or no]

Steps

  1. Leave every fenced code block, inline code span, command, file path, URL and anchor link unchanged.
  2. Translate headings, prose, table text and image alt text.
  3. Translate code comments only if asked, without touching the code on the same line.
  4. Keep heading levels, lists, tables and link targets exactly as in the source.
  5. Use one translation per technical term throughout.

Output format

  1. The full translated document in Markdown.
  2. | Term | Kept in English or translated | Translation |
  3. A check table: code blocks, inline code, links and headings counted in the source and in the translation, which must match.
  4. Lines where the meaning was unclear, marked [check].

Rules

  • Never translate keywords, parameter names, error strings the code prints, or anything inside backticks.
documentation translationreadme translationapi docs translationtechnical writing translationmarkdown translationdeveloper docs localization

How to run this

Copy the prompt and paste it into Gemini, then set the aspect ratio to 3:4. No reference photo is needed for this one.

The prompt is written in Markdown with each part under its own heading, which is what the copy action hands over. Change one section at a time, keeping the rest intact, so you can tell which change did the work.

Related prompts

All productivity