Markdown-review ender ofte med et praktisk spørgsmål: hvordan deler du resultatet med en person, der ikke skal læse kilden? Raw Markdown er godt for forfattere og udviklere, men det er ikke altid det bedste format for en product manager, kunde eller reviewer, der bare skal se det renderede indhold.
Markdown-validatoren har nu en kompakt downloadmenu til forhåndsvisningen. Herfra kan du hente det renderede resultat som TXT, PDF eller Word DOCX, mens download af kilde-Markdown stadig er en separat handling for selve .md-indholdet.
Renderet forhåndsvisning frem for kilde
Preview-eksporterne bygges fra sanitiseret renderet HTML. Filen følger derfor den tekst og struktur, du ser i preview-panelet, ikke den rå Markdown direkte. Hvis en reviewer skal vurdere overskrifter, afsnit, tabeller eller links som læser, er preview-eksporten den rigtige. Hvis en udvikler skal committe source, er Markdown-downloaden den rette fil.
Hvilket format skal du bruge
- TXT passer til hurtig copy review, søgning, arkiv eller systemer, der modtager plain text.
- PDF passer bedre, når du vil sende en stabil fil til læsning, deling eller approval.
- Word DOCX er nyttigt, når en editor eller kunde forventer kommentarer og tekstrettelser i et dokument.
Hvad bliver bevaret
Eksporterne prioriterer et læsbart dokument, ikke en pixel-perfect kopi af browserens preview. De bevarer overskrifter, afsnit, lister, tabeller, code blocks, blockquotes, links, image alt text og udtrukket KaTeX-tekst, når den findes.
Workflowet er kort: indsæt Markdown, tjek preview, ret warnings, åbn downloadmenuen og vælg TXT, PDF eller Word efter næste reviewer.
For en bredere Markdown QA-gennemgang, læs hvordan du fanger Markdown-problemer før publicering. Før commit kan du bruge workflowet til GitHub-flavored Markdown-preview. Til teamreview passer workflowet for product- og docs-teams.
