ai-insights-translate

Markdown publishing for translated articles requires writing structured content, localizing image links to site-relative paths, updating _meta.json with tags and contributors, and validating JSON before running the build.

Image localization during article translation downloads original images into the site's images folder and rewrites text image links to local paths only, ensuring external dependencies are removed.

The translation process preserves original titles, sections, and steps, and supports optional Twitter and Medium structured parsing to maintain high-fidelity structure for site-ready Chinese reads.

The workflow adds the translated entry to the correct markdown file, updates _meta.json with tags and contributors, and modifies the yearly index page to reflect the new content automatically.

Quality gates include running JSON validation to ensure metadata correctness and executing a site build to verify that the translated content is correctly integrated into the markdown site.

The best way is to use a translation workflow that downloads original images into the site's images folder, rewrites text image links to local paths, and validates the build to ensure images load correctly.