Markdowni ülevaatus lõpeb sageli praktilise küsimusega: kuidas jagada tulemust inimesega, kes ei peaks source'i lugema? Raw Markdown sobib autoritele ja arendajatele, kuid see ei ole alati parim formaat product managerile, kliendile või ülevaatajale, kes peab nägema ainult renderdatud sisu.
Markdowni valideerija sisaldab nüüd kompaktset download-menüüd eelvaate jaoks. Sealt saab renderdatud tulemuse alla laadida TXT, PDF või Word DOCX failina, samal ajal kui source Markdowni allalaadimine jääb eraldi toiminguks .md sisu jaoks.
Renderdatud eelvaade, mitte source
Eelvaate ekspordid luuakse sanitiseeritud renderdatud HTML-ist. Fail järgib preview-paneelis nähtavat teksti ja struktuuri, mitte otse raw Markdown source'i. Kui reviewer peab lugema pealkirju, lõike, tabeleid või linke lõppkasutaja vaates, on eelvaate eksport õige fail. Kui arendaja peab source'i commitima, on Markdowni allalaadimine täpsem.
Millist vormingut kasutada
- TXT sobib kiireks copy review'ks, otsinguks, arhiiviks või süsteemidesse, mis võtavad vastu plain text'i.
- PDF sobib paremini stabiilseks lugemis-, jagamis- või kinnitamisfailiks.
- Word DOCX sobib siis, kui toimetaja või klient ootab kommentaare ja tekstiparandusi dokumendis.
Mis säilib
Ekspordid eelistavad loetavat dokumenti, mitte brauseri preview pixel-perfect koopiat. Alles jäävad headings, lõigud, loendid, tabelid, code blocks, blockquotes, lingid, piltide alt text ja võimalusel ekstraheeritud KaTeX tekst.
Praktiline töövoog on lühike: kleebi Markdown, kontrolli preview'd, paranda warnings, ava download-menüü ja vali TXT, PDF või Word järgmise revieweri järgi.
Laiema Markdown QA jaoks loe kuidas leida Markdowni probleeme enne avaldamist. Enne commit'i aitab GitHub-flavored Markdowni eelvaate workflow. Tiimiülevaatuseks kasuta product ja docs tiimide workflow'd.
