translate-markdown

Translate Markdown content while preserving structure and code blocks.

2|Updated Mar 10, 2026
One-click install
npx skills add https://github.com/tim-hub/powerball --skill translate-markdown
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: translate-markdown
Source: https://github.com/tim-hub/powerball/tree/main/personal/skills/translate-markdown
Command: npx skills add https://github.com/tim-hub/powerball --skill translate-markdown

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Translates Markdown content into a target language while preserving formatting and structure to reduce manual localization work.

Core Features & Use Cases

  • Preserve Markdown syntax (headings, bold, italic, links, lists, tables, code fences) while translating prose.
  • Translate code blocks' comments and docstrings without altering code.
  • Output to a specified path or return translated content for further processing in workflows.
  • Ideal for localizing README files, documentation, and knowledge bases.

Quick Start

Supply the Markdown file and target language, and specify an optional output path to generate the translated document.

Frequently Asked Questions about translate-markdown

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I translate markdown files while preserving formatting and code blocks?

To translate markdown files while preserving formatting, supply the file and target language to generate translated prose that keeps headings, links, lists, and code fences intact. Code logic remains unaltered, while comments and docstrings inside the blocks are translated.

What is the best way to localize README files into another language without breaking markdown syntax?

Localizing README files without breaking markdown syntax is handled by enforcing rules that keep structural elements like code fences, URLs, and file paths intact. This ensures the translated output remains valid markdown for documentation workflows.

Can I translate code block comments in markdown documentation without altering the actual code?

Yes, you can translate code block comments in markdown documentation without altering the actual code. The process isolates code logic and only translates human-readable comments and docstrings within the fenced blocks.

Does markdown translation leave URLs and file paths untouched?

Markdown translation leaves URLs and file paths untouched by explicitly avoiding the translation of identifiers and links. This preserves the structural integrity and navigation of your multilingual documentation.

How do I output translated markdown content to a specific file path for multilingual documentation?

You can output translated markdown content to a specific file path by specifying an optional output path during the process. This allows you to directly save the translated document or return the content for further workflow processing.