Come tradurre file Markdown

Tradurre file Markdown è facile e veloce con il nostro strumento basato su IA. Segui questi passaggi per ottenere traduzioni accurate e che preservano il formato per la tua documentazione, i file README e il contenuto di siti statici.

1. Incolla il tuo contenuto Markdown: Copia e incolla il contenuto del tuo file .md nell'area di testo sopra. Supporta Markdown standard, GitHub Flavored Markdown (GFM) e Markdown con front matter YAML.
2. Imposta la lingua di destinazione: Inserisci il codice lingua ISO in cui desideri tradurre (es. fr per francese, de per tedesco, ja per giapponese).
3. Fai clic su Traduci: La nostra IA tradurrà il contenuto testuale preservando tutta la formattazione Markdown: intestazioni, grassetto/corsivo, elenchi, blocchi di codice, link, immagini e front matter.
4. Copia o salva il risultato: Una volta completata la traduzione, copia il Markdown tradotto negli appunti o salvalo direttamente come file .md.

Cos'è Markdown e perché tradurlo?

Markdown è un linguaggio di markup leggero che converte il testo semplice in HTML formattato. Creato da John Gruber nel 2004, è diventato il formato standard per documentazione, file README, wiki e sistemi di gestione dei contenuti in tutto il mondo. La sua sintassi semplice e leggibile lo rende ideale per redattori tecnici, sviluppatori e creatori di contenuti.

Poiché i prodotti software e la documentazione raggiungono un pubblico globale, tradurre il contenuto Markdown diventa essenziale. Localizzare i tuoi file README, guide utente, documentazione API e post di blog garantisce che gli utenti di diverse lingue possano comprendere e utilizzare appieno il tuo prodotto. Una documentazione mal localizzata o non tradotta è una delle maggiori barriere all'adozione internazionale.

Tradurre Markdown manualmente è soggetto a errori: è facile rompere accidentalmente la sintassi di formattazione, corrompere i blocchi di codice o danneggiare le strutture dei link. La nostra traduzione basata su IA preserva tutti gli elementi di sintassi traducendo accuratamente solo il contenuto testuale leggibile dall'uomo.

Sintassi e struttura Markdown

Un tipico documento Markdown contiene un mix di elementi di testo formattato. Il nostro motore di traduzione li comprende e li preserva tutti:

# Getting Started

Welcome to **My Application**! This guide will help you get up and running quickly.

## Installation

Run the following command to install:

```bash
npm install my-application
```

## Features

- Fast and lightweight
- Easy to configure
- Supports multiple languages

> **Note:** Make sure you have Node.js 18 or higher installed.

For more information, see the [documentation](https://example.com/docs).

• Intestazioni (#, ##, ###): I titoli delle sezioni vengono tradotti mentre i marcatori di livello dell'intestazione vengono preservati esattamente così come sono.
• Grassetto e corsivo (**testo**, *testo*): I marcatori di enfasi inline vengono mantenuti intatti attorno al testo tradotto.
• Elenchi ordinati e non ordinati (-, *, 1.): La struttura dell'elenco e la nidificazione vengono preservate; viene tradotto solo il testo dell'elemento dell'elenco.
• Blocchi di codice (```) e codice inline (`): Tutto il contenuto del codice viene preservato intatto. L'IA non traduce mai codice, comandi o identificatori tecnici.
• Link ([testo](url)) e immagini (![alt](src)): Gli URL e i percorsi delle immagini rimangono invariati. Vengono tradotti solo il testo del link e il testo alternativo dell'immagine.
• Citazioni (>): I marcatori di citazione vengono preservati; il contenuto del testo citato viene tradotto.

Supporto front matter YAML

Molti file Markdown utilizzati nei generatori di siti statici (Jekyll, Hugo, Docusaurus, Gatsby) includono front matter YAML: metadati nella parte superiore del file delimitati da ---. La nostra IA gestisce in modo intelligente il front matter:

---
title: "User Guide"
description: "Complete guide for using our application"
lang: en
sidebar_label: "User Guide"
---

# User Guide

This page explains how to use the core features of our application.

## Quick Start

1. Open the application
2. Sign in with your account
3. Select your preferred language from the settings

## Support

If you need help, please visit our [support page](https://example.com/support)
or contact us at support@example.com.

Valori traducibili come <code>title</code>, <code>description</code> e <code>sidebar_label</code> vengono tradotti, mentre chiavi tecniche come <code>date</code>, <code>slug</code>, <code>lang</code>, <code>draft</code> e <code>weight</code> vengono lasciate invariate. Ciò garantisce che i tuoi file Markdown tradotti siano immediatamente compatibili con il tuo generatore di siti statici o CMS.

Markdown nella localizzazione software

Markdown è diventato un cittadino di prima classe nella localizzazione software. Con la diffusione delle pratiche di documentazione come codice, i team archiviano la documentazione nei repository Git insieme al codice sorgente, e Markdown è il formato preferito. Localizzare questa documentazione richiede lo stesso rigore della localizzazione delle stringhe UI.

Le moderne piattaforme di localizzazione supportano sempre più Markdown insieme a formati tradizionali come XLIFF, PO e JSON. Che tu stia localizzando un repository GitHub, un sito web di documentazione o una knowledge base, la traduzione Markdown è ora una parte fondamentale del flusso di lavoro di internazionalizzazione.

Localizzazione Markdown per generatori di siti statici

I generatori di siti statici si affidano a file Markdown con front matter per contenuti multilingue. Ogni lingua ha solitamente la propria directory di file Markdown tradotti:

• Jekyll: Utilizza _posts e directory di contenuto con cartelle per lingua o front matter specifico per lingua. Il jekyll-multiple-languages-plugin e jekyll-polyglot di Jekyll gestiscono pagine Markdown multilingue.
• Hugo: Supporta la traduzione dei contenuti tramite directory specifiche per lingua (content/en/, content/fr/) o aggiungendo codici lingua ai nomi dei file (about.fr.md). La modalità multilingue integrata di Hugo è ampiamente utilizzata per siti di documentazione e marketing.
• Docusaurus: Il Docusaurus di Facebook utilizza una cartella i18n/ dedicata per le pagine Markdown tradotte, con la stessa struttura di file rispecchiata per ogni lingua. Tradurre file Markdown di Docusaurus è uno dei casi d'uso più comuni per la localizzazione Markdown.
• Gatsby: I siti Gatsby utilizzano plugin come gatsby-plugin-i18n e archiviano i contenuti tradotti come file Markdown separati per locale, spesso con front matter che specifica la lingua e lo slug.
• VitePress: il framework di documentazione VitePress di Vue utilizza sottodirectory specifiche per lingua per i file Markdown tradotti, facilitando la manutenzione della documentazione tecnica multilingue.

Traduzione di README e documentazione tecnica

I file README e la documentazione tecnica sono tra i contenuti di maggior impatto da localizzare per i progetti open source e gli strumenti per sviluppatori:

• File README.md: la prima cosa che gli utenti vedono su GitHub, npm o PyPI. Un README tradotto aumenta significativamente l'adozione nei mercati non anglofoni. Tradurre il tuo README in cinese, giapponese, coreano, spagnolo o portoghese può espandere drasticamente la portata del tuo progetto.
• GitHub Wiki: le Wiki di GitHub utilizzano Markdown e sono sempre più localizzate per i grandi progetti open source. Le pagine wiki tradotte aiutano i collaboratori e gli utenti di diverse regioni a comprendere la documentazione del progetto.
• CHANGELOG.md e note di rilascio: tradurre i changelog e le note di rilascio aiuta gli utenti internazionali a capire cosa è cambiato tra le versioni e come ciò li influenzi.
• Documentazione API: la documentazione di riferimento delle API scritta in Markdown (utilizzando strumenti come Slate, Redoc o Swagger UI) beneficia della traduzione per aiutare gli sviluppatori di diverse regioni a integrare le tue API in modo più efficace.

Generazione di glossario IA per traduzioni Markdown

La nostra funzione di generazione del glossario IA ti aiuta a mantenere una terminologia coerente in tutta la tua documentazione Markdown. Attivala selezionando Genera glossario nelle opzioni di traduzione:

• Terminologia coerente: l'IA analizza il contenuto Markdown di origine e le traduzioni di destinazione esistenti per creare un glossario di termini chiave, assicurando che nomi di prodotti, concetti tecnici ed etichette dell'interfaccia utente siano tradotti in modo coerente in tutte le pagine della documentazione.
• Termini specifici del dominio: fornisci un campione di contenuto Markdown già tradotto nel campo delle stringhe di destinazione. L'IA apprende la tua terminologia preferita e la applica automaticamente alle nuove pagine di documentazione.
• Come utilizzarlo: incolla il tuo contenuto Markdown tradotto nel campo opzionale delle stringhe di destinazione che appare quando la generazione del glossario è abilitata. L'IA estrae coppie di termini ricorrenti e le utilizza come guida alla traduzione. Se non viene fornito alcun contenuto di destinazione, l'IA genera un glossario solo dalla documentazione di origine.

Perché utilizzare l10n.dev per la traduzione Markdown?

• Traduzione contestuale basata su IA: la nostra IA comprende la struttura Markdown e traduce il testo con consapevolezza del contesto, della terminologia tecnica e della documentazione circostante.
• Conservazione completa del formato: intestazioni, grassetto/corsivo, elenchi, tabelle, citazioni e tutta la sintassi Markdown vengono conservati esattamente. Solo il testo leggibile dall'uomo viene tradotto.
• Supporto per front matter: il front matter YAML viene gestito in modo intelligente: i metadati traducibili come titoli e descrizioni vengono tradotti; i campi tecnici come slug, date e ID rimangono invariati.
• Protezione dei blocchi di codice: tutti i blocchi di codice (recintati e rientrati), il codice inline e gli identificatori tecnici vengono lasciati completamente intatti durante la traduzione.
• Conservazione di link e immagini: tutti gli URL, i percorsi delle immagini, le ancore e i link di riferimento rimangono intatti. Solo il testo del link e il testo alternativo dell'immagine vengono tradotti.
• Conveniente: il nostro servizio è più accessibile rispetto ad altre soluzioni di traduzione automatica. Gli utenti ricevono 10,000 caratteri gratuiti ogni mese.Visualizza prezzi
• Ottimizzato per documenti lunghi: elabora in modo efficiente file Markdown estesi (post di blog, pagine di documentazione complete e guide multi-sezione), mantenendo la coerenza di traduzione in tutto il documento.

Casi d'uso comuni per la traduzione Markdown

La traduzione Markdown è utilizzata in un'ampia gamma di scenari di documentazione e localizzazione dei contenuti:

• Localizzazione di README.md: traduci i tuoi file README su GitHub, GitLab o Bitbucket per aiutare gli sviluppatori internazionali a comprendere il tuo progetto, i passaggi di installazione e gli esempi di utilizzo.
• Siti web di documentazione: traduci siti di documentazione Docusaurus, VitePress, MkDocs o GitBook per rendere la documentazione tecnica accessibile agli sviluppatori di tutto il mondo.
• Contenuti di siti statici: traduci i contenuti delle pagine Jekyll, Hugo, Gatsby o Astro per fornire siti web multilingue con una corretta SEO per ogni lingua.
• Pagine GitHub Wiki: localizza le wiki dei progetti open source per aiutare collaboratori e utenti di diversa provenienza linguistica a navigare e contribuire al tuo progetto.
• Post di blog tecnici: traduci post di blog per sviluppatori, tutorial e guide pratiche scritte in Markdown per raggiungere ingegneri e utenti tecnici a livello globale.
• Articoli della knowledge base: traduci articoli di aiuto, FAQ e documentazione di supporto archiviata come Markdown in strumenti come l'esportazione di Notion, Outline o knowledge base personalizzate.
• Note di rilascio e changelog: traduci i file CHANGELOG.md e le note di rilascio affinché i team e gli utenti internazionali rimangano informati sugli aggiornamenti del prodotto nella loro lingua.

Markdown vs. altri formati di localizzazione

Markdown occupa una posizione unica nell'ecosistema di localizzazione. A differenza di JSON, YAML o XLIFF (che archiviano stringhe di traduzione isolate), i file Markdown contengono documenti in prosa completi con contenuti misti: testo in linguaggio naturale, esempi di codice, sintassi strutturata e metadati. Ciò rende la traduzione Markdown fondamentalmente diversa dalla localizzazione basata su stringhe.

I flussi di lavoro di localizzazione tradizionali estraggono le stringhe traducibili in file di risorse e le traducono individualmente. La localizzazione Markdown invece traduce interi documenti preservandone la struttura. Ciò richiede un'IA che comprenda quali parti del documento debbano essere tradotte (prosa, intestazioni, elementi di elenco, testo alternativo) e quali non debbano mai essere toccate (blocchi di codice, URL, chiavi di front matter).

La nostra traduzione IA gestisce i documenti Markdown in modo nativo: non è necessario pre-elaborare o estrarre stringhe. Incolla il tuo file Markdown, seleziona una lingua di destinazione e ricevi un file <code>.md</code> completamente tradotto e strutturalmente intatto, pronto per essere inviato al tuo repository.

Domande frequenti

Quali elementi Markdown vengono conservati durante la traduzione?

Tutta la sintassi Markdown viene conservata: intestazioni (#, ##), grassetto (**), corsivo (*), elenchi, tabelle, citazioni (>), link ([testo](url)), immagini (![alt](src)) e blocchi di codice recintati (```). Il contenuto del codice all'interno di blocchi e backtick non viene mai tradotto.

Il front matter YAML viene tradotto?

Sì, in modo selettivo. La nostra IA traduce i campi del front matter leggibili dall'uomo come title, description e sidebar_label. I campi tecnici come slug, date, lang, draft, weight e id vengono lasciati invariati per garantire la compatibilità con il tuo generatore di siti statici.

Come traduco un file Markdown?

Incolla il contenuto del tuo file .md nell'editor qui sopra, inserisci il codice della lingua di destinazione (es. fr, de, ja, zh) e fai clic su Traduci. L'IA restituirà un documento Markdown completamente tradotto preservando tutta la formattazione. Puoi copiare il risultato o salvarlo come file .md.

Posso tradurre file Markdown di grandi dimensioni?

Questa pagina funziona meglio per singoli file Markdown fino a poche centinaia di kilobyte. Per la traduzione in blocco di Markdown o documenti molto lunghi, consigliamo di utilizzare la pagina Traduzione file i18n, che supporta caricamenti di file fino a 5 MB e fornisce una consegna più affidabile per la localizzazione di contenuti su larga scala.