Funcionament de la conversió de Markdown a Word i HTML
Aquesta eina permet escriure o enganxar text en format Markdown i visualitzar en temps real com quedarà el document final. El sistema processa la sintaxi introduïda i ofereix la possibilitat de convertir aquest contingut en un document de Microsoft Word (.docx) o en codi HTML net. Durant tot el procés d'edició, l'usuari disposa d'un recompte de paraules i de caràcters per monitorar l'extensió del text.
L'editor admet les estructures comunes de Markdown, incloent-hi encapçalaments, llistes ordenades i desordenades, taules, enllaços, blocs de codi, èmfasi (negretes i cursives) i llistes de tasques. Si l'àrea d'entrada de text està buida, l'espai destinat a la visualització mostra el missatge "La vista prèvia amb format i l'HTML apareixerà aquí.". En prémer el botó per netejar l'editor, l'estat de l'aplicació canvia a "S'ha buidat l'editor." i el comptador de caràcters es restableix a 0.
Processament local i privacitat de les dades
El funcionament d'aquest conversor es basa íntegrament en l'execució en el client. El seu Markdown se processa al navegador. No es puja res a BroBroGo.
La generació de la vista prèvia, l'exportació del codi HTML i la creació del document de Word (.docx) s'executen localment mitjançant els recursos del propi navegador de l'usuari. Al no haver-hi transferència de fitxers ni de text cap a servidors externs, el procés de conversió s'ajusta a fluxos de treball on es requereix que la informació no surti del dispositiu local.
Mapeig de Markdown a l'estructura de Microsoft Word
El format Markdown és un llenguatge de marcatge lleuger que utilitza caràcters de text pla per definir l'estructura d'un document. Quan es genera un fitxer de Microsoft Word (.docx), l'eina tradueix aquests elements de text pla en els estils natius de l'arquitectura XML de Word.
- Encapçalaments: Els elements
#a######es converteixen en els estils de títol corresponents (Títol 1 a Títol 6). L'eina utilitza el primer encapçalament H1 trobat en el text per definir el nom del fitxer.docx exportat. - Llistes i tasques: Les llistes de punts (
-o*) i numerades esdevenen llistes estructurades de Word. Les llistes de tasques es tradueixen mantenint el seu caràcter d'element de llista. - Taules i codi: Les taules definides amb canonades i guions es dibuixen com a taules de Word amb files i columnes definides. Els blocs de codi mantenen la seva tipografia monoespaiada.
L'exportació local a Word té un límit de capacitat determinat pel processament del navegador. Si el volum de text és excessiu, es mostra l'error "Aquest Markdown és massa gran per a l'exportació local a Word. Mantingui'l per sota dels {max} caràcters.". Si es produeix qualsevol altra anomalia durant la generació del fitxer, el sistema mostra el missatge "La conversió ha fallat. Proveu-ho amb un document Markdown més petit.". Si s'intenta realitzar una exportació sense haver introduït text, l'eina avisa amb el missatge "Encara no hi ha res per exportar; primer escrigui una mica de Markdown.".
Generació d'HTML net i seguretat
L'exportació a HTML d'aquesta eina es caracteritza per oferir un codi net i lliure d'elements superflus. L'HTML generat es pot copiar directament al porta-retalls o bé descarregar-se com un document independent senzill.
Per garantir la integritat del codi resultant, l'HTML sense format que s'hagi pogut introduir manualment dins del text Markdown s'escapa abans de procedir a la renderització de l'exportació. Això evita l'execució de scripts no desitjats o la ruptura de l'estructura del document. A més, tots els enllaços que s'inclouen tant a la vista prèvia com a l'HTML de sortida incorporen de manera automàtica els atributs rel="noopener noreferrer". Aquests atributs bloquegen l'accés del lloc web de destinació a la finestra d'origen i eviten la tramesa de la informació de referència, millorant el comportament dels enllaços externs.
Bones pràctiques per a la preparació de documents
Per assegurar una conversió òptima a Word o HTML, és recomanable seguir certes pautes estructurals en redactar el Markdown:
| Element Markdown | Sintaxi recomanada | Comportament en la conversió |
|---|---|---|
| Títol principal | # Títol del Document |
Defineix el nom del fitxer.docx de sortida. |
| Enllaços | [Text](url) |
S'exporten amb noopener noreferrer. |
| Taules | Files separades per | i línia de divisió |---| |
Es converteixen en taules estructurades de Word. |
| Èmfasi | **text** per a negreta, *text* per a cursiva |
Es tradueixen en estils de caràcter rics. |
Aquestes directrius faciliten que autors, redactors de notes tècniques, creadors de manuals d'instruccions i desenvolupadors que necessiten lliurar fitxers README en formats tradicionals obtinguin documents perfectament llegibles i compatibles amb lectors de pantalla i altres tecnologies d'assistència.
Preguntes freqüents
Es puja el meu Markdown al servidor?
No. La vista prèvia, l'exportació HTML i la generació del document de Word s'executen localment al navegador.
Què es conserva en l'exportació a Word?
El fitxer DOCX manté l'estructura habitual de Markdown, com ara encapçalaments, llistes, taules, enllaços, blocs de codi, èmfasi i llistes de tasques.
L'exportació HTML inclou scripts no segurs?
No. L'HTML sense format de l'interior del Markdown s'escapa abans de renderitzar-se, i l'HTML baixat és un document independent senzill.
Com es determina el nom del fitxer Word descarregat?
L'eina utilitza el text del primer encapçalament H1 (el títol principal precedit d'un sol #) que troba en el document Markdown per anomenar el fitxer.docx resultant.