translation

To translate Markdown documentation while preserving code blocks and front-matter, use this Skill to process READMEs and guides. It translates prose content from a source to a target language without altering fenced code blocks, indented code, or YAML/TOML front-matter.

Yes, you can batch translate an entire directory of Markdown files without changing the structure. This Skill supports batch directory translation and automatically maintains relative paths while converting prose content to your target language.

The deep-translator library handles the translation engine, while this Skill adds front-matter detection to ensure YAML and TOML metadata is preserved. It isolates front-matter from prose so that only the content text is processed during localization.

The best way to localize READMEs and guides is to apply this translation Skill to individual files or directories. It specifically targets Markdown formatting to ensure that structural elements like headings and links remain intact during the localization process.

Yes, you need Python to run the Markdown translation process because this Skill depends on the deep-translator Python library. You must have the Python environment configured and the dependency installed to execute the translation scripts.

Translated Markdown documentation often has broken formatting if the tool does not isolate code blocks. This Skill prevents broken formatting by applying code-block preservation logic, ensuring fenced and indented code is skipped during the translation process.