Markdown docs-vertaler
Vertaal Markdown- en MDX-documentatie, zonder dat code of links veranderen
Upload .md- of .mdx-bestanden, of je hele docs-map als .zip, kies een taal en ontvang dezelfde map vertaald terug. Codeblokken, inline code, link- en afbeeldingsadressen, frontmatter-sleutels, MDX-imports en componenten blijven exact zoals ze zijn; koppen, alinea's, lijsten, tabellen, alt-teksten en frontmatter-titels en -beschrijvingen worden vertaald. Het eerste deel is gratis en zonder account; een complete docs-map tot 1,000,000 tekens kost $5 als eenmalige betaling. Een chatbot kan prima een README vertalen, maar bij een documentatiesite van vijftig bestanden krijg je vaak vertaalde code, kapotte links en gewijzigde frontmatter terug.
- Tot 40 alinea's volledig gratis; bij grotere opdrachten is het eerste deel gratis
- Hele opdracht $5: een docs-map (.zip) of tot 50 bestanden, tot 1,000,000 tekens
- Codeblokken, inline code, URL's, frontmatter-sleutels en MDX-componenten worden nooit vertaald
- Dezelfde mapstructuur terug als .zip; afbeeldingen en configuratiebestanden blijven ongewijzigd
- Werkt met Docusaurus, MkDocs, Hugo, Astro, VitePress, Next.js en GitHub-README's
- 81 talen, met woordenlijst en te behouden productnamen
Wat je terugkrijgt
Een los bestand krijgt de taalcode in de naam (README.md wordt README.de.md). Een map krijg je terug als .zip met dezelfde paden onder een map met de taalcode, bijvoorbeeld docs-de/, direct klaar om te kopiëren naar i18n/de of de locale-map van je site. Voordat je downloadt, zie je elk tekstblok inclusief Markdown op het scherm naast het origineel staan en kun je het direct bewerken.
- Koppen behouden hun ankers (zoals {#install}); lijsten behouden hun opsommingstekens en inspringing; tabellen behouden hun pipes en uitlijnrijen.
- Links: de linktekst wordt vertaald, het adres en de titel blijven gelijk; referentiedefinities zoals [docs]: https://… blijven onaangeroerd.
- Frontmatter: title, description, summary, sidebar_label en vergelijkbare tekstvelden worden vertaald; slugs, datums, tags, id's en alle andere sleutels blijven exact zoals ze zijn geschreven.
- MDX: import- en exportregels, JSX-componentregels en {expressies} worden één-op-één overgenomen.
Documentatie vertalen: met een chatbot versus met deze tool
Een losse README vertaalt een chatbot meestal prima. Maar een documentatiesite bestaat uit tientallen bestanden vol syntax die absoluut niet mag veranderen – en niemand controleert dat wanneer een chatbot de tekst herschrijft.
| Jouw situatie | Een chatbot | Deze tool |
|---|---|---|
| Eén korte README | Vertaalt meestal prima | Vertaalt de tekst en houdt de Markdown exact intact |
| Een docs-map met 60 bestanden | Bestand voor bestand, met de hand; lange bestanden kappen halverwege af | Het hele .zip-bestand in één opdracht, dezelfde mappenstructuur terug |
| Codeblokken en inline code | Vertaalt soms per ongeluk opmerkingen, variabelen of commando's | Wordt nooit ter vertaling aangeboden; byte voor byte overgenomen |
| Links en afbeeldingen | Vertaalt of herschrijft soms paden en ankers | Adressen worden verborgen voor het model en ongewijzigd teruggeplaatst |
| Frontmatter | Vertaalt geregeld sleutels zoals slug of id | Alleen tekstvelden zoals title en description worden vertaald |
| MDX-componenten | Herschrijft soms JSX of props | Import-, export- en componentregels blijven exact zoals ze zijn |
Zo vertaal je een map met Markdown-documentatie
-
1
Upload bestanden of een .zip en kies een taal
Sleep je .md-, .mdx- of .markdown-bestanden hierheen, of zip je docs-map en upload de .zip. Kies de taal en voeg eventueel productnamen of termen toe die ongewijzigd moeten blijven.
-
2
Controleer het eerste deel gratis
De eerste tekstblokken verschijnen direct op het scherm naast het origineel. Pas ze naar wens aan. Je hebt geen account nodig.
-
3
Ontgrendelen en downloaden
Ontgrendel de hele opdracht voor $5 en download de vertaalde map als .zip, inclusief een lijst met waarschuwingen als er ergens iets extra aandacht vraagt.
Waarom algemene AI-assistenten struikelen over documentatie
Markdown combineert gewone tekst met elementen die dat beslist niet zijn: code, commando's, bestandspaden, ankers, YAML-sleutels en in MDX zelfs JavaScript. Een assistent die het hele bestand herschrijft, moet al die elementen feilloos kopiëren terwijl hij de omringende woorden vertaalt – bestand na bestand. Je merkt het pas laat als een commando per ongeluk is vertaald of een linkpad is aangepast.
Deze tool leest elk bestand regel voor regel, slaat codeblokken, MDX-importregels en componentregels volledig over, en vervangt inline code, linkadressen, afbeeldingspaden en {expressies} door korte markeringen voordat er iets naar het model gaat. Alleen koppen, alinea's, lijstitems, tabelcellen, alt-teksten en frontmatter-tekstvelden worden vertaald, per blok met de bestandsnaam als context. Elk markeringsteken moet verplicht terugkomen. Vervolgens wordt het bestand opgebouwd vanuit de originele regels.
Wat gebruikers zoal vertalen
- Documentatiesites gebouwd met Docusaurus, VitePress, MkDocs, Hugo en Astro
- GitHub-README's, CONTRIBUTING-handleidingen en als Markdown geëxporteerde wiki's
- Notities uit Obsidian of Notion, geëxporteerd naar Markdown
- Blogartikelen en kennisbanken die als .md-bestanden worden beheerd
- Cursusmateriaal en boeken geschreven in Markdown
Goed om te weten qua limieten
In de frontmatter worden uitsluitend tekstvelden vertaald (zoals title, description, summary, excerpt en sidebar_label); YAML-waarden over meerdere regels en lijsten blijven ongewijzigd. Ruwe HTML-blokken worden vertaald met behoud van de tags. Commentaar binnen codeblokken wordt bewust nooit vertaald. Bestanden in een .zip die geen Markdown zijn, worden ongewijzigd meegekopieerd.
Een eenmalige betaling dekt tot 1,000,000 tekens aan tekst (ongeveer 300 pagina's) in een .zip of tot 50 losse bestanden; Unlimited dekt tot 2,000,000 tekens. Controleer het resultaat altijd voor publicatie, vooral merknamen en vakjargon; de woordenlijst helpt om deze consistent te houden.
Per taal en situatie
Vertaal een Docusaurus docs-map
Zip je docs-map, upload hem en ontvang dezelfde bestanden vertaald terug, direct klaar om in i18n/<locale>/doc...
Lees meer →Vertaal een README naar het Chinees
Upload README.md, of de hele docs-map als .zip, en ontvang deze terug in Vereenvoudigd of Traditioneel Chinees...
Lees meer →MDX-bestanden vertalen
Upload .mdx-bestanden of een gezipte contentmap en ontvang ze vertaald terug, met elke import- en exportregel,...
Lees meer →Wat het kost
Kleine opdrachten, eerste deel
Gratis
Tot 40 alinea's volledig gratis, inclusief downloaden. Bij grotere opdrachten is het eerste deel gratis te bekijken, zonder account.
Hele opdracht
$5
Eenmalige betaling voor een complete docs-map of tot 50 bestanden, tot 1,000,000 tekens. Geen abonnement.
Unlimited
$19 / week
Toegang tot elke tool op de site, voor opdrachten tot 2,000,000 tekens.
Vragen en antwoorden
Kan ChatGPT Markdown-bestanden vertalen zonder dat er iets stukgaat?
Voor één kort bestand lukt dat meestal wel. Maar bij een hele documentatiemap is het traag, worden lange bestanden afgekapt en controleert niets of code, links en frontmatter-sleutels intact zijn gebleven. Deze tool stuurt nooit code of adressen door ter vertaling en bouwt elk bestand opnieuw op vanuit je origineel.
Worden codeblokken vertaald?
Nee. Fenced codeblokken, inline code en ingesprongen code worden exact overgenomen, inclusief het commentaar daarin.
Werkt het ook met MDX?
Ja. Import- en exportregels, regels met louter JSX-componenten en {expressions} blijven onaangeroerd; de lopende tekst ertussenin wordt vertaald.
Wat gebeurt er met frontmatter?
Tekstvelden zoals title, description, summary en sidebar_label worden vertaald. Sleutels, slugs, datums, tags, id's en andere waarden blijven exact zoals ze er stonden.
Kan ik een hele map uploaden?
Ja. Zip de map en upload het .zip-bestand. Je krijgt een .zip terug met dezelfde paden in een map vernoemd naar de taal; afbeeldingen en andere bestanden worden ongewijzigd meegekopieerd.
Hoeveel kan ik vertalen voor $5?
Tot 1,000,000 tekens aan tekst, ongeveer 300 pagina's, in één opdracht: een .zip of maximaal 50 bestanden van maximaal 100 MB. Code en frontmatter-sleutels tellen niet mee.
Is het gratis?
Het eerste deel van elke opdracht wordt gratis vertaald en op het scherm getoond. Een opdracht van maximaal 40 alinea's is helemaal gratis, inclusief download. Grotere opdrachten kosten $5, eenmalig betaald.
Zijn mijn bestanden privé?
Alleen jij kunt je opdracht openen. De tekst wordt uitsluitend naar een AI-modelleverancier gestuurd om deze te vertalen en wordt niet gebruikt voor training. Opdrachten die zonder account zijn geüpload, worden na 7 dagen verwijderd, en je kunt een opdracht op elk gewenst moment zelf wissen.
Bijgewerkt op 25 oktober 2026 · APPFACT STUDIO LTD