text-translator

NoteMD Pro - Translation

Overview

This feature translates markdown notes to different languages using LLM. It supports single file translation, batch folder translation, and preserves markdown formatting and special elements like images.

When to Use

• Multi-language vault: Create translated versions of notes
• Language learning: Translate content for study
• International collaboration: Share notes across languages
• Content localization: Adapt content for different audiences

Function Call Chain

translateFile (translate.ts)
├── read_file(inputPath)
├── splitContent(content, settings)
├── getProviderForTask('translate', settings)
├── callLLM(provider, prompt, chunk)
│   └── Translated chunk
├── join translated chunks
├── save translated file
│   └── write_file(outputPath, content)
└── open file (if enabled)

batchTranslateFolder
├── filter .md files in folder
├── createConcurrentProcessor
├── processFile for each file
└── ProgressModal reporting

Key Functions (from translate.ts)

translateFile

Translates a single file to target language.

export async function translateFile(
  settings: NotemdSettings,
  inputPath: string,
  targetLanguage: string,
  progressReporter: ProgressReporter,
  openFile?: boolean,
  signal?: AbortSignal,
): Promise<string | null>;
// Returns: Path to translated file

batchTranslateFolder

Translates all markdown files in a folder.

export async function batchTranslateFolder(
  settings: NotemdSettings,
  folderPath: string,
  targetLanguage: string,
): Promise<void>;

Settings

Translation Settings

Setting	Description
translateProvider	LLM provider for translation
translateModel	Model for translation

Output Settings

Setting	Description
useCustomTranslationSuffix	Use custom filename suffix
translationCustomSuffix	Custom suffix (e.g., "_es", "_fr")
useCustomTranslationSavePath	Use custom save path
translationSavePath	Custom save path