Markdown vertalen is eenvoudig, totdat je tweehonderd pagina’s hebt. Dan zijn de woorden niet het probleem, maar alles eromheen: code die niet mag veranderen, links die moeten blijven werken en de volgende release met weer tien extra pagina’s.
Deze gids is bedoeld voor documentatiesites, README’s, changelogs en blogmappen die in Markdown of MDX zijn geschreven.
Welke optie moet je gebruiken?
| Geschikt voor | Waar het minder geschikt voor is | |
|---|---|---|
| AI Glot | Een documentatiemap, meerdere talen, een woordenlijst die consequent moet worden toegepast en elke release | Niet nodig voor één korte alinea in een README |
| Een platform voor vertaalbeheer (Crowdin, Lokalise, Phrase) | Een team met een doorlopende workflow, reviewers en een koppeling met een repository | Je moet eerst een project opzetten en je repository koppelen voordat de eerste pagina wordt verwerkt |
| DeepL | De documenten die het ondersteunt: Word, PowerPoint, Excel, PDF, HTML, tekst en andere | Markdown staat niet op die lijst, dus je moet eerst tekst plakken of het bestand omzetten |
| ChatGPT, Claude of een andere assistent | Eén korte pagina | Je plakt elke pagina apart en voegt je woordenlijst aan elk gesprek toe. Je moet elke pagina controleren op gewijzigde code of links. Een grote documentatiemap verbruikt bovendien je gebruikslimiet |
| Een freelancer of bureau | De landingspagina en de prijspagina | Duurt lang, wordt per woord berekend en je moet de bestanden nog steeds zelf voorbereiden |
Laat iemand de pagina lezen die het product verkoopt. Verwerk de referentiedocumentatie met een vertaalmachine, want daar zit het volume.
Waarom AI Glot geschikt is voor een documentatiemap
- Inhoud erin, structuur blijft intact. Koppen, alinea’s, lijstitems en tabelcellen zijn tekst. Code, linkdoelen, HTML-blokken en scheidingstekens in tabellen blijven ongewijzigd.
- Opmaak blijft bij de juiste woorden. Vetgedrukte en cursieve tekst en linkteksten blijven bij de woorden waarop ze betrekking hebben.
- Eén woordenlijst voor de hele documentatiesite. Je productnamen en API-termen worden op elke pagina en in de volgende release hetzelfde vertaald.
- Eerst een overzicht, dan pas kosten. Je ziet wat er is gevonden en wat er wordt vertaald.
- Een hele map in één opdracht. Stop de bestanden in een ZIP en de mappenstructuur wordt hersteld.
Het traject van één bestand
- 1UploadenEen .md- of .mdx-bestand, of een ZIPMaximaal 4 MB per bestand
- 2Geef aan wat je nodig hebtEén gewone zinGratis
- 3Bekijk het planWat het opleverde: talen, kostenGratis
- 4GoedkeurenDe enige stap die iets kostVerbruikt credits
- 5DownloadenVertaald MarkdownZet het erin
Wat er op een pagina verandert
Alleen de tekst verandert. De code, de link en de sleutels in de front matter blijven hetzelfde.
---title: Install the CLItitle: Installer la CLIslug: install---Run `npm install -g tool` and read the [guide](/nl/docs/setup).Lancez `npm install -g tool` et lisez le [guide](/nl/docs/setup).Waar je op let in MDX
Imports, componenttags en expressies blijven ongewijzigd. Zo blijft de pagina goed bouwen. Let wel op tekst die je als prop aan een component meegeeft, bijvoorbeeld een titel voor een kaart. Die hoort bij de component en niet bij de lopende tekst, dus controleer die paar strings achteraf.
Ankers bij koppen. Als je site een anker maakt op basis van de koptekst, krijgt een vertaalde kop een nieuw anker. Controleer links naar koppen, zoals die naar de sectie Install.
Zo doe je het, stap voor stap
1. Probeer gratis een bestand uit. De Markdown-vertaler vereist geen account en verwerkt bestanden tot 2 MB en 5,000 woorden.
2. Upload het bestand of een ZIP-bestand van de map in de app.
3. Geef in één zin aan wat je nodig hebt.
Translate this folder into French.
Translate the prose and the front matter title and description.
Leave every other front matter field as it is.De zin bepaalt wat er in de hele map wordt vertaald. Een regel over woordkeuze, zoals “houd productnamen en API-termen in het Engels”, vul je bij goedkeuring in het tweede vak in, omdat die regel op elke alinea wordt toegepast terwijl die wordt geschreven.
4. Voeg een woordenlijst toe voor productnamen, API-termen en woorden die je altijd op dezelfde manier gebruikt. Zo stel je er een samen.
5. Bekijk het abonnement en kies een kwaliteitsniveau.
Lite levert ongeveer drie keer zoveel woorden per tegoed op en is sneller: ideaal om de referentiedocumentatie in één keer bij te werken. Standard is bedoeld voor de landingspagina. Eén tegoed staat gelijk aan één woord in Standard.
6. Keur het resultaat goed en download het.
Eén documentatiemap, meerdere talen
De aantallen zijn voorbeelden. Een Markdown-bestand bevat één taal, dus voor elke taal is er een eigen vertaalde kopie van de map.
Drie manieren om het te gebruiken
Via de opdrachtregel is geschikt voor een documentatierepository, omdat je dezelfde vier stappen in een script of in CI kunt uitvoeren zodra de Engelse tekst verandert:
id=$(aiglot batches create docs.zip \
--instruction "Translate into French. Translate the prose and the front matter title and description." \
--json | jq -r '.data.id')
aiglot batches get "$id" --json | jq '.data.plan'
aiglot batches approve "$id" --quality lite \
--instructions "Keep product names and API terms in English."
aiglot batches download "$id" --output docs_fr.zipMet je AI-agent: koppel AI Glot als MCP-server. De agent kan je repository uitlezen, de gevonden termen voorstellen voor de woordenlijst, de opdracht uitvoeren en de bestanden weer op hun plek zetten.
In de app: uploaden, klikken, downloaden. Handig voor één pagina.
Bekijk voor een API-integratie de API-documentatie.
Controleer het resultaat
Bouw de documentatiesite in één vertaalde taal en open drie pagina’s: één met code, één met een tabel en één met een link naar een andere pagina. Voer je gebruikelijke linkchecker uit, want daar valt een gewijzigde ankerlink op. Bewaar de Engelse bestanden totdat iemand die de taal beheerst de belangrijkste pagina’s heeft bekeken.
Op de pagina Prijzen zie je wat een groter volume kost. Met een gratis account krijg je credits om een echte map te vertalen.
De hier vermelde limieten golden op het moment dat dit werd geschreven: 4 MB per Markdown-bestand, 200 bestanden en 20 MB per ZIP-bestand, en 2 MB en 5,000 woorden in de gratis tool. De lijst van DeepL komt uit de eigen documentatie. Bestandsnamen en aantallen pagina’s in de diagrammen zijn voorbeelden. In je abonnement zie je de werkelijke aantallen voor je eigen bestanden, en dat kun je gratis bekijken.