Markdownin tarkistus päätyy usein käytännön kysymykseen: miten jaat tuloksen henkilölle, jonka ei pitäisi lukea lähdekoodia? Raw Markdown sopii kirjoittajille ja kehittäjille, mutta se ei aina ole paras muoto product managerille, asiakkaalle tai reviewerille, joka haluaa nähdä vain renderöidyn sisällön.
Markdown-validaattori sisältää nyt kompaktin latausvalikon esikatselulle. Sen kautta voit viedä renderöidyn tuloksen TXT-, PDF- tai Word DOCX -tiedostona, kun taas lähde-Markdownin lataus pysyy erillisenä toimintona varsinaiselle .md-sisällölle.
Renderöity esikatselu vai source
Esikatselun exportit luodaan sanitisoidusta renderöidystä HTML:stä. Tiedosto seuraa preview-paneelissa näkyvää tekstiä ja rakennetta, ei suoraan raw Markdown sourcea. Jos reviewer arvioi otsikoita, kappaleita, taulukoita tai linkkejä lukijana, esikatselun export on oikea tiedosto. Jos kehittäjän pitää commitoida source, Markdown-lataus on tarkempi.
Mitä muotoa kannattaa käyttää
- TXT sopii nopeaan copy review'hun, hakuun, arkistointiin tai järjestelmiin, jotka hyväksyvät plain textin.
- PDF on parempi, kun tarvitset vakaan tiedoston lukemista, jakamista tai hyväksyntää varten.
- Word DOCX sopii, kun editori tai asiakas odottaa kommentteja ja tekstikorjauksia dokumentissa.
Mitä säilytetään
Exportit painottavat luettavaa dokumenttia, eivät pixel-perfect kopiota selaimen preview'stä. Ne säilyttävät otsikot, kappaleet, listat, taulukot, code blockit, lainaukset, linkit, kuvien alt-tekstit ja saatavilla olevan KaTeX-tekstin.
Käytännön workflow on lyhyt: liitä Markdown, tarkista preview, korjaa warnings, avaa latausvalikko ja valitse TXT, PDF tai Word seuraavan reviewerin mukaan.
Laajempaan Markdown QA -kierrokseen lue kuinka löydät Markdown-ongelmat ennen julkaisua. Ennen commitia käytä GitHub-flavored Markdown -esikatselun workflow'ta. Tiimitarkistukseen sopii product- ja docs-tiimien workflow.
