Tria un fragment per publicar o un fitxer per compartir
Un lloc web o un sistema de gestió de continguts pot necessitar HTML encara que prefereixis escriure en Markdown. Obre el fitxer .md o enganxa’n el contingut, revisa el resultat i tria entre un fragment de contingut i un document HTML complet.
«Copia l’HTML» retorna un fragment de contingut. «Baixa l’HTML» l’empaqueta en un document amb estils i fonts de matemàtiques incrustades. Són resultats diferents: un fragment necessita el CSS de la destinació, mentre que el fitxer baixat ja incorpora els estils del document.
Què conté l’HTML generat
Estructura llegible
Els encapçalaments, les llistes, les citacions, les taules i els enllaços es converteixen en elements HTML. Canvia de «Previsualització» a HTML per inspeccionar el fragment generat.
Dos formats de sortida útils
Copia un fragment per a un CMS o baixa un document HTML complet per revisar-lo i compartir-lo. No cal que eliminis l’embolcall d’una pàgina sencera quan la destinació només necessita el contingut.
Inclou exemples tècnics
Es poden ressaltar els llenguatges de codi habituals; les fórmules i els diagrames Mermaid compatibles es renderitzen abans d’exportar. Els errors d’exportació es mostren en lloc de substituir el contingut sense avisar.
Dona estil a un document independent
Defineix la tipografia i els colors abans de baixar l’HTML. Els diagrames renderitzats s’incrusten com a SVG i les fonts de matemàtiques s’inclouen al fitxer baixat.
Comença amb un document que realment necessitis
Una secció de documentació
Converteix una secció breu d’un article per afegir-la a una documentació existent.
## Instal·lació Instal·la el paquet i **comprova el resultat**. ```bash npm ci ``` > Conserva una còpia del Markdown original.
- El nivell de l’encapçalament s’adapta a la pàgina amfitriona
- Les ordres són llegibles
- La citació té un context significatiu
Una taula comparativa per a un blog
Conserva la informació tabular com a cel·les HTML reals en lloc d’una captura de pantalla.
## Formats de distribució | Format | Pas següent recomanat | | --- | --- | | Markdown | Continua editant | | HTML | Publica al web | | PDF | Comparteix per llegir |
- Hi ha cel·les de capçalera
- El text cap en pantalles estretes
- S’han revisat els enllaços
Un flux de treball pràctic
Enganxa Markdown o obre un fitxer
Fes servir el codi font del teu article o README. L’HTML en brut que no pertany al petit conjunt d’etiquetes de format compatibles es mostra com a text.
Inspecciona les dues vistes
Revisa el document, canvia a HTML i comprova els encapçalaments, els enllaços i l’estructura de les taules. Assegura’t que la destinació accepti els elements que necessites.
Tria entre un fragment i un document
Copia l’HTML per a un editor de publicació que accepti codi. Baixa l’HTML si vols un fitxer amb format. Prova el resultat a la destinació real abans de publicar-lo.
Revisa el resultat abans de compartir-lo
| Contingut | Què cal fer | Què pots esperar |
|---|---|---|
| Fragment HTML | Comprova quines etiquetes HTML i estils CSS admet la destinació. | Un CMS pot filtrar estils, SVG o fórmules encara que es mostrin en aquesta previsualització. |
| HTML independent | Obre el fitxer baixat per separat. | Inclou els estils del document i les fonts de matemàtiques; les imatges externes activades continuen depenent dels seus servidors. |
| Enllaços i scripts | Revisa els destins dels enllaços; no facis servir la conversió per distribuir scripts. | El conversor elimina el contingut actiu i tracta com a text l’HTML en brut que no és compatible. |
Preguntes sobre aquest flux de treball
Com puc convertir Markdown a HTML per a un lloc web?
Obre el fitxer .md o enganxa el codi font i revisa la previsualització. Després, fes servir «Copia l’HTML» per obtenir el codi del contingut. Tria «Baixa l’HTML» si necessites un document complet amb estils. Abans de publicar, comprova com gestiona el lloc web l’HTML que hi enganxes.
Quina diferència hi ha entre «Copia l’HTML» i «Baixa l’HTML»?
«Copia l’HTML» et dona el fragment de contingut. «Baixa l’HTML» crea un document complet amb títol, estils i contingut renderitzat.
Puc convertir taules Markdown en taules HTML?
Sí. Les taules amb barres verticals es converteixen en elements de taula HTML. Les taules complexes amb cel·les combinades no formen part de la sintaxi Markdown bàsica i pot ser que s’hagin d’editar manualment.
L’HTML inclou fórmules i Mermaid?
Les fórmules compatibles es renderitzen amb KaTeX i els diagrames Mermaid s’incrusten com a SVG. El document baixat inclou les fonts de matemàtiques; un fragment copiat pot necessitar estils de la destinació.
Puc enganxar el resultat a qualsevol CMS?
Comprova primer les regles del CMS. Alguns editors accepten codi font HTML; d’altres mostren les etiquetes com a text o eliminen SVG i fórmules. Prova una mostra petita dins del procés de publicació real.
L’HTML baixat funciona completament sense connexió?
Inclou els estils del document, els diagrames renderitzats i les fonts de matemàtiques. Les imatges i els enllaços externs continuen apuntant a les adreces originals, tret que la imatge estigui incrustada.
Es puja Markdown per convertir-lo?
La conversió de Markdown a HTML i la baixada de l’HTML es fan al navegador. Només l’acció independent «Baixa el PDF» envia el document renderitzat a aquest lloc web.
Com tracta aquesta eina el teu document
- L’anàlisi de Markdown i la generació d’HTML es fan localment.
- L’HTML copiat és un fragment; l’HTML baixat és un document amb format.
- S’elimina el contingut actiu, però revisa els enllaços i comprova les regles del teu CMS.
Referències dels formatsReferència dels elements HTMLEspecificació de CommonMark
Informa d’un problema que es pugui reproduirIndica el navegador, la configuració triada i un exemple petit sense informació confidencial. No enviïs documents privats per correu electrònic.
