Llegeix un fitxer i decideix què vols canviar
Busques un visor MD en línia per llegir un README o uns apunts? Obre el fitxer .md i tria «Previsualització» per llegir-lo. Si el vols modificar, canvia a «Editor» o «Vista dividida»; el codi font continua disponible per inspeccionar-lo i desar-lo.
Fes servir les dreceres de teclat per editar més de pressa, obre un fitxer si ja tens un esborrany i decideix si vols desar-lo localment. Un esborrany desat al navegador pertany a aquest perfil del navegador; no és una còpia de seguretat al núvol.
Un editor que manté el codi font a la vista
Llegeix un fitxer MD sense editar-lo
Fes servir la previsualització com a visor de fitxers MD per llegir encapçalaments, llistes, taules i codi. Amaga el panell del codi font perquè puguis llegir el document; quan tornis a l’editor no perdràs el text.
Insereix-hi els elements més complexos
Crea una taula inicial, afegeix una equació en línia o en bloc, insereix un exemple de Mermaid o incrusta una imatge ràster local. Després, edita directament el codi font inserit.
Previsualitza Markdown mentre escrius
Tria «Vista dividida» per veure el codi font i el document renderitzat de costat. Els canvis apareixen després d’una pausa breu mentre escrius, de manera que és més fàcil comprovar l’alineació de les taules, els blocs de codi i les fórmules compatibles. En documents llargs pot ser necessari actualitzar la previsualització manualment.
Tria com vols treballar
Fes servir els modes «Editor», «Previsualització» o «Vista dividida», activa el mode de concentració, ajusta la tipografia i amplia el document. Baixa Markdown quan necessitis una còpia portable.
Comença amb un document que realment necessitis
Un README de projecte
Obre un README per llegir-lo ràpidament i, després, fes servir la vista dividida per revisar-ne les instruccions de configuració.
# Nom del projecte Una explicació breu de **què fa aquest projecte**. ## Primers passos ```bash npm ci ``` ## Passos següents - [ ] Afegeix un exemple funcional - [ ] Revisa la documentació
- Primer paràgraf clar
- Ordres dins de blocs de codi
- Llista de comprovació amb accions
Una nota de decisió amb un diagrama
Conserva el raonament i el diagrama de flux en un únic fitxer font.
# Flux de revisió ```mermaid flowchart LR A[Esborrany] --> B[Revisió] B --> C[Publicació] ``` El revisor comprova les afirmacions abans de compartir el document.
- La sintaxi del diagrama és vàlida
- Les etiquetes són llegibles
- El text explica el diagrama
Obre, previsualitza i desa el document
Obre un fitxer o enganxa’n el contingut
Tria «Obre un fitxer» per a un document .md o enganxa Markdown a l’editor. Si tens un README a GitHub, desa primer el fitxer en brut; introduir-ne l’adreça web no importa el document.
Llegeix-lo o revisa els canvis al costat del codi font
Tria «Previsualització» per llegir sense el panell del codi font. Per revisar el document, fes servir «Vista dividida» i consulta els canvis mentre edites. La barra d’eines t’ajuda a afegir encapçalaments, enllaços, llistes i taules sense haver de memoritzar tota la sintaxi.
Desa una còpia que puguis continuar editant
Tria «Baixa el MD» per conservar el codi font al dispositiu. L’HTML és útil per tenir un document renderitzat; fes servir l’eina de PDF si necessites una còpia de lectura per compartir. El desament d’esborranys al navegador és opcional i no substitueix un fitxer desat.
Revisa el resultat abans de compartir-lo
| Contingut | Què cal fer | Què pots esperar |
|---|---|---|
| Format accidental | Revisa el codi font generat després d’una acció de la barra d’eines. | La negreta i les llistes continuen sent Markdown normal i es poden modificar manualment. |
| Recuperació d’esborranys | Activa el desament, fes un petit canvi, torna a carregar la pàgina i recupera l’esborrany. | L’emmagatzematge és específic del dispositiu i la configuració del navegador el pot esborrar. |
| Text generat per IA | Verifica les dades i corregeix els blocs de codi sense tancar o les fórmules no compatibles. | El format pot millorar la llegibilitat, però no demostra que la informació sigui certa. |
Preguntes sobre aquest flux de treball
Puc fer-lo servir com a visor MD en línia sense editar?
Sí. Tria «Obre un fitxer», selecciona el document .md i canvia a «Previsualització». Podràs llegir el contingut renderitzat sense modificar el codi font. Quan vulguis editar-lo, torna a «Editor» o «Vista dividida».
Com puc previsualitzar un fitxer MD en línia mentre escric?
Enganxa el codi font o obre un fitxer i tria «Vista dividida». La previsualització s’actualitza després d’una breu pausa mentre escrius. Si s’atura automàticament perquè el document és llarg, tria «Actualitza la previsualització». No cal pujar el document per editar-lo o veure’n el resultat.
Puc fer-lo servir sense conèixer tota la sintaxi Markdown?
La barra d’eines insereix la sintaxi habitual i els exemples et serveixen de punt de partida. Si mantens el codi font a la vista, podràs aprendre què canvia cada botó.
On es desen els esborranys?
Només en aquest navegador si actives el desament local. No se sincronitzen entre dispositius i s’eliminen quan esborres les dades del navegador. Baixa el MD per conservar-ne una còpia duradora.
Què passa amb un document molt llarg?
Pots continuar editant-lo i baixar-ne el codi font. Pot ser que la previsualització automàtica s’aturi per mantenir l’editor àgil; actualitza-la manualment quan vulguis revisar el resultat.
S’admeten etiquetes HTML?
L’editor accepta un conjunt reduït d’etiquetes de format sense atributs per subratllar, fer superíndexs i subíndexs, indicar tecles i ressaltar. La resta d’HTML en brut es mostra com a text.
Puc fer servir fórmules i diagrames?
L’editor renderitza les fórmules KaTeX compatibles i els blocs de codi Mermaid. El contingut no vàlid s’indica perquè el puguis corregir abans d’exportar el resultat renderitzat.
Com tracta aquesta eina el teu document
- L’editor i la previsualització funcionen al navegador.
- El desament local d’esborranys és opcional i es pot desactivar o esborrar.
- La baixada de PDF és una operació independent que es fa al servidor; també hi ha la impressió local i les baixades d’MD/HTML.
Referències dels formatsAjuda de CommonMarkEspecificació de GitHub Flavored Markdown
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.
