@quick-start-soft/quick-markdown-translator

Markdown Translator CLI

Command-line interface that translates Markdown documents through the Gemini API with strict fidelity to the source.

Features

• 엄격한 원문 충실성: Maintains original structure and expressions
• Heading-based parallel translation: Processes documents in parallel for speed
• Smart content protection: Preserves code blocks, URLs, and other non-translatable elements
• Automatic retry logic: Handles API failures gracefully
• Dynamic rate limiting: Adapts to API limits automatically
• Comprehensive logging: Detailed error tracking for debugging

Installation

npm install -g @quick-start-soft/quick-markdown-translator

Usage

markdown-translator <input-file.md> [options]

Required Environment Variables

export GEMINI_API_KEY="your-gemini-api-key"

Options

• --target-lang <code>: Target language code (default: 'ko' for Korean)
• --concurrency <number>: Maximum simultaneous API requests (default: 200)
• --model <name>: Gemini model to use (default: 'gemini-2.5-pro')

Examples

# Translate to Korean (default)
markdown-translator document.md

# Translate to English
markdown-translator document.md --target-lang en

# Translate to Spanish with custom concurrency
markdown-translator paper.md --target-lang es --concurrency 100

# Use a specific model
markdown-translator doc.md --model gemini-1.5-pro

Available Models

• gemini-2.5-pro (default) - Most intelligent AI model with advanced reasoning capabilities
• gemini-2.0-flash - Fast and efficient next-generation model
• gemini-1.5-flash - Fast and efficient for most use cases
• gemini-1.5-pro - More capable but slower, better for complex translations

Protected Elements

The following elements are automatically protected from translation:

• Code blocks (```and`)
• Inline code
• URLs and links
• Images
• HTML tags
• Frontmatter

Output

Translated files are saved in the same directory as the input file with .translated.md suffix:

• Input: document.md
• Output: document.translated.md

Translation Style

The translator prioritizes:

• 원문 충실성 (Fidelity to source): Exact structure and expressions
• 공식적 직역 (Official literal translation): Suitable for legal/academic documents
• Grammatical accuracy: While maintaining source structure

Development

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

# Link for local development
npm run link:global

License

Proprietary - Closed source