Tradotto con l’IA di Lara Translate
Se devi tradurre un file Markdown online, uno strumento di traduzione generico lo rovinerà. Markdown sembra testo normale, ma in realtà è un formato strutturato: intestazioni, code blocks, sintassi dei link, front matter e inline code hanno tutti significati precisi da cui dipende il rendering. Se incolli un file .md in Google Translate, otterrai un file in cui gli esempi di codice sono tradotti nella lingua di destinazione, gli URL dei link sono parzialmente riscritti e le chiavi YAML del front matter sono state modificate. Il documento che ne risulta non verrà visualizzato correttamente, o non verrà visualizzato affatto.
|
TL;DR
|
Risposta breve
Per tradurre un file Markdown senza danneggiare la sintassi, ti serve uno strumento che capisca il formato, non un traduttore generico. Carica il tuo file .md su Lara Translate, scegli la lingua di destinazione e scarica un file tradotto in cui i code blocks, gli URL dei link, i percorsi delle immagini e il front matter vengono mantenuti esattamente come nel file di origine.
Perché è importante: Markdown è il formato di contenuto per i README di GitHub, i documenti di Docusaurus, i siti MkDocs, i blog Hugo e migliaia di strumenti per sviluppatori. Se i file Markdown tradotti non si renderizzano correttamente, rompono gli esempi di codice o compromettono la navigazione, la documentazione localizzata danneggia attivamente gli utenti invece di aiutarli.
Traduci i file Markdown senza modificare la sintassi
Carica qualsiasi file .md o .markdown. Lara protegge automaticamente i code fence, gli URL dei link, il front matter e l’inline code, e traduce solo la prosa. Pronto per essere integrato nel tuo framework di documentazione.
Cos’è un file Markdown?
Markdown è un linguaggio di markup leggero che usa convenzioni di formattazione in testo semplice per definire la struttura del documento. Un file con estensione .md o .markdown contiene un mix di testo e sintassi che un renderer Markdown converte in HTML, PDF o altri formati.
I file Markdown sono lo standard per la documentazione degli sviluppatori (file README, Docusaurus, MkDocs), per i contenuti di siti statici (Hugo, Jekyll, Gatsby) e per strumenti di scrittura tecnica come Notion, Obsidian e GitHub.
Elementi di sintassi che devono rimanere intatti dopo la traduzione:
- Intestazioni: #, ##, ### — definiscono la struttura del documento e generano link di ancoraggio
- Code blocks: il contenuto tra i code fence a triplo backtick non va mai tradotto
- Codice inline: il contenuto tra i singoli backtick è un riferimento al codice, non testo
- Link: nella sintassi [text](url), puoi tradurre solo il testo del link — l’URL deve rimanere invariato
- Immagini: in , puoi tradurre l’alt text, ma non il percorso dell’immagine
- Front matter: il blocco YAML delimitato da — all’inizio di molti file Markdown — i nomi delle chiavi non devono essere modificati
Chi deve tradurre i file Markdown
Maintainer open source che vogliono che i loro file README, le guide per i contributori e i wiki siano accessibili ai contributori internazionali. È meno probabile che uno sviluppatore giapponese o brasiliano contribuisca se trova un file README solo in inglese.
I team di documentazione per gli sviluppatori che devono fornire la documentazione in più lingue insieme al prodotto. Se il tuo sito usa Docusaurus, MkDocs o Hugo, i tuoi file di contenuto sono file .md: localizzarli significa tradurli correttamente.
Scrittori tecnici e team DevRel che creano tutorial e guide in Markdown per un pubblico in mercati come Giappone, Germania, Brasile e Corea, dove le community di sviluppatori hanno forti preferenze per i contenuti nella propria lingua.
Team SaaS e di prodotto che usano strumenti CMS headless come Contentful o Strapi e memorizzano i contenuti in formato Markdown, localizzando i testi del prodotto per più mercati.
Tre modi per tradurre i file Markdown
Opzione 1 — Lara Translate (syntax-aware, online)
Il traduttore Markdown di Lara capisce il formato. Rileva i code fence e protegge tutto quello che c’è dentro. Mantiene intatti gli URL dei link, i percorsi delle immagini, la struttura del front matter e l’inline code. Viene tradotta solo la prosa leggibile da persone. L’output è un file Markdown valido e renderizzabile.
Opzione 2 — Piattaforme i18n dedicate (SimpleLocalize, Crowdin)
Alcune piattaforme di localizzazione supportano Markdown nelle loro pipeline. Funzionano bene per i team che hanno già un’infrastruttura di localizzazione consolidata, ma richiedono la configurazione del progetto, l’accesso per i collaboratori e la definizione di un flusso di lavoro: troppo per un singolo README o per un piccolo sito di documentazione.
Opzione 3 — Traduzione manuale o strumenti di IA generici
Se copi il Markdown in Google Translate o chiedi a un’IA generica di «tradurre questo», ottieni risultati poco affidabili. I blocchi di codice vengono tradotti, la sintassi dei link viene rovinata, i nomi delle chiavi del front matter vengono modificati. Può funzionare per file brevi e semplici, ma non va bene su larga scala.
Come tradurre un file Markdown con Lara — passo dopo passo
- Vai su laratranslate.com/translate-markdown
- Carica il tuo file .md o .markdown
- Scegli la tua lingua di partenza e quella di arrivo (ne supportiamo più di 200)
- Aggiungi un glossario per i termini tecnici, i nomi dei prodotti o le etichette dell’interfaccia utente che non vanno tradotti
- Scegli lo stile di traduzione — Faithful per la documentazione, Fluid per i contenuti del blog
- Clicca su Translate e scarica il file di output
Il motore di Lara rileva e protegge automaticamente i code fence, l’inline code, gli URL dei link, i percorsi delle immagini e il front matter. Non serve nessuna pre-elaborazione.
Cosa controllare dopo aver tradotto un file Markdown
Code blocks: renderizza l’output e controlla che tutti gli esempi di codice vengano mostrati correttamente. Il contenuto dentro i code fence a triplo backtick deve essere identico alla sorgente: nessun nome di variabile tradotto, nessuna sintassi modificata.
Link: clicca sui link nell’output renderizzato. La parte URL di [text](url) deve rimanere invariata. I link di ancoraggio (#header-name) devono puntare ancora a intestazioni valide — controlla se il testo tradotto delle intestazioni corrisponde agli anchor nel file.
Front matter: controlla che le chiavi come title:, description:, slug: e lang: non siano state modificate. Puoi tradurre stringhe di valore come title; in genere, i valori di slug non vanno tradotti.
Espansione del testo: tedesco, finlandese e olandese sono espansori comuni. Se il tuo Markdown viene visualizzato su un sito di documentazione con colonne o celle di tabella a larghezza fissa, controlla che le stringhe più lunghe non rompano il layout.
Hai altri file Markdown da tradurre?
Lara ti permette di caricare file in blocco: puoi tradurre un’intera cartella di documenti o tutti i file .md di un repo GitHub in un’unica sessione. Oltre 200 lingue, con la sintassi mantenuta invariata ovunque.
FAQ
Lara traduce il contenuto dentro i code blocks?
No. Il processore Markdown di Lara riconosce i code fence a triplo backtick e considera tutto ciò che c’è dentro come non traducibile. Anche l’inline code (tra backtick singoli) è protetto.
Cosa succede al front matter YAML quando traduco un file Markdown?
Lara mantiene la struttura del front matter. I nomi delle chiavi non vengono tradotti. Se serve, puoi tradurre le stringhe di valore come title e description. Valori tecnici come slug, date, lang e layout restano invariati.
Posso tradurre file Markdown per un sito Docusaurus o MkDocs?
Sì. Entrambi i framework usano file .md come fonti di contenuto. Traduci i file con Lara, metti l’output nella directory della locale giusta e il framework mostrerà automaticamente la versione tradotta agli utenti nella locale corrispondente.
Posso tradurre più file Markdown contemporaneamente?
Sì. Lara supporta i caricamenti in blocco: in una sola sessione puoi caricare tutti i file .md di un intero sito di documentazione o di una cartella di un repository.
Lara supporta i file MDX (Markdown con JSX)?
I file MDX seguono la sintassi Markdown, ma incorporano componenti JSX. Il processore di Lara protegge i code blocks e l’inline code, che coprono la maggior parte del contenuto JSX. Se hai file MDX con tanto JSX incorporato, controlla bene l’output per assicurarti che la sintassi dei componenti non sia stata modificata.
Questo articolo tratta di
- Spiegare perché i file Markdown hanno bisogno di una traduzione che tenga conto della sintassi e non di uno strumento generico.
- Identificare i tre principali punti deboli: traduzione dei code blocks, struttura dei link rotta e front matter modificato.
- Confronto tra i metodi per tradurre file .md online: Lara Translate, piattaforme i18n dedicate e metodi manuali.
- Guida passo passo a come tradurre un file Markdown con Lara e a cosa controllare nell’output.
- Casi d’uso: localizzazione di README, documentazione per sviluppatori, siti statici e contenuti di CMS headless.
Traduci i tuoi file Markdown
Carica il tuo file .md o .markdown su laratranslate.com/translate-markdown e ottieni una traduzione precisa, dove ogni code block, ogni link e ogni campo del front matter sono esattamente dove dovrebbero essere.
Anche in questa serie:
