Review Markdown często kończy się praktycznym pytaniem: jak udostępnić wynik osobie, która nie powinna czytać źródła? Raw Markdown jest dobry dla autorów i developerów, ale nie zawsze jest najlepszym formatem dla product managera, klienta lub reviewera, który chce zobaczyć tylko wyrenderowaną treść.
Walidator Markdown ma teraz kompaktowe menu pobierania dla podglądu. Z tego menu można wyeksportować wyrenderowany wynik jako TXT, PDF lub Word DOCX, a pobieranie źródłowego Markdown pozostaje osobną akcją dla rzeczywistej treści .md.
Renderowany podgląd zamiast source
Eksporty podglądu powstają z oczyszczonego, wyrenderowanego HTML. Plik odzwierciedla tekst i strukturę widoczne w panelu preview, a nie bezpośrednio raw Markdown source. Jeśli reviewer ma czytać nagłówki, akapity, tabele lub linki jak końcowy odbiorca, właściwy jest export podglądu. Jeśli developer ma commitować source, dokładniejszy będzie download Markdown.
Którego formatu użyć
- TXT przydaje się do szybkiej korekty copy, wyszukiwania, archiwizacji lub systemów przyjmujących plain text.
- PDF jest lepszy, gdy potrzebny jest stabilny plik do czytania, udostępniania lub akceptacji.
- Word DOCX pasuje, gdy redaktor lub klient oczekuje komentarzy i zmian tekstu w dokumencie.
Co jest zachowane
Eksporty stawiają na czytelny dokument, nie na pixel-perfect kopię podglądu w przeglądarce. Zachowują nagłówki, akapity, listy, tabele, bloki kodu, cytaty, linki, alt text obrazów i wyodrębniony tekst KaTeX, jeśli jest dostępny.
Praktyczny workflow jest krótki: wklej Markdown, sprawdź preview, popraw warnings, otwórz menu pobierania i wybierz TXT, PDF lub Word według następnego reviewera.
Dla szerszego Markdown QA przeczytaj jak wychwycić problemy z Markdown przed publikacją. Przed commitem użyj workflowu podglądu GitHub-flavored Markdown. Do review zespołowego połącz to z workflowem dla product i docs teams.
