Traduci un file Markdown
Questo strumento traduce un file Markdown mantenendo la formattazione: titoli, elenchi, tabelle, link e blocchi di codice restano al loro posto, cambia solo il testo. Incolli il .md, scegli la lingua di arrivo e riottieni lo stesso documento, con la stessa struttura, pronto per la tua documentazione o il tuo README.
Esegui online
Esegui questo sui nostri server con il tuo account. Gli strumenti gratuiti girano nel tuo browser; questo viene addebitato sul tuo saldo KIT al prezzo indicato sopra.
Il codice resta codice
In un file Markdown i blocchi di codice, i comandi da terminale e i nomi di funzione non vanno tradotti: un `git push` deve restare `git push`. Qui i blocchi tra backtick e le porzioni recintate (```) vengono riconosciuti e lasciati intatti, mentre viene tradotto il testo intorno: le spiegazioni, i titoli, le voci di elenco. Anche i link mantengono l’URL e traducono solo l’etichetta visibile.
La formattazione non salta
Grassetto, corsivo, livelli dei titoli, elenchi puntati e numerati, tabelle e citazioni restano nella stessa forma dell’originale. Riottieni un .md che renderizza esattamente come quello di partenza, senza asterischi fuori posto o tabelle scomposte. Lo apri nel tuo editor o lo pubblichi così com’è.
Per documentazione e README
È lo strumento giusto quando scrivi documentazione tecnica, un README di progetto o un articolo in Markdown e ti serve la versione in un’altra lingua. Il costo si conta a parola di testo tradotto — non sui blocchi di codice — quindi paghi per il contenuto reale. Il limite pratico è di circa 20.000 token per richiesta: una guida lunga si divide per sezioni.
Casi d'uso
Il README in inglese
Luca Esposito pubblica una libreria e ha il README in italiano. Lo traduce in inglese mantenendo i blocchi di comando intatti: cambiano le spiegazioni, non le istruzioni da copiare.
La documentazione del prodotto
Un piccolo team traduce in francese la guida utente scritta in Markdown, tenendo tabelle e screenshot referenziati al loro posto, pronta per il sito di documentazione.
L’articolo tecnico
Alessandro Ferrari riusa un articolo del blog in inglese: traduce il .md, i link agli approfondimenti restano validi e deve solo rileggere i termini tecnici prima di pubblicare.
Domande frequenti
Traduce anche il codice dentro i blocchi?
No, e di proposito: i blocchi tra backtick e quelli recintati restano intatti, così i comandi e gli esempi funzionano ancora. Viene tradotto solo il testo intorno al codice.
I link continuano a funzionare?
Sì: l’URL non cambia, viene tradotta solo l’etichetta visibile del link. Anche le immagini referenziate restano collegate ai file originali.
La formattazione resta intatta?
Sì: titoli, elenchi, tabelle, grassetto e citazioni mantengono la stessa marcatura. Il file renderizza come l’originale, nella nuova lingua.
Quanto costa?
$0.003 a richiesta più $0.0135 ogni 1.000 parole di testo. I blocchi di codice non rientrano nel conteggio, quindi paghi solo per le parole effettivamente tradotte.
Quanto può essere lungo il file?
Circa 20.000 token per richiesta. Una documentazione estesa conviene tradurla una sezione alla volta e poi ricomporla nel file finale.
Per sviluppatori — accesso via API
Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.
Endpoint
Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.
Chiamala dal tuo stack
curl -X POST https://api.kit.forhosting.com/translate/markdown \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"…"}'const res = await fetch("https://api.kit.forhosting.com/translate/markdown", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"text": "…"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/translate/markdown",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"text": "…"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/translate/markdown", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"text":"…"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"text":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/translate/markdown", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Esempio di richiesta
{
"text": "…"
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "translate.markdown",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.
Prezzi
Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.
Limiti
max_tokens | 20000 |
Errori
| HTTP | Codice | Significato |
|---|---|---|
401 | unauthorized | Chiave API mancante o non valida: controlla l'header Authorization. |
402 | insufficient_balance | Credito esaurito: ricarica per continuare a eseguire attività. |
404 | unknown_type | Tipo di attività sconosciuto: controlla il campo type della richiesta. |
429 | rate_limited | Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo. |
422 | task_failed | L'attività non è andata a buon fine: non ti viene addebitato nulla. |