Markdown sang PDF
Dán Markdown hoặc thả một tệp .md. Tương thích với GitHub-Flavored Markdown. 100% trong trình duyệt: không có gì được tải lên.
Thả một tệp .md hoặc .markdown
hoặc nhấn để chọn một tệp — chỉ được đọc trong trình duyệt của bạn
Lý tưởng cho README kỹ thuật và ghi chú. Bảng bị làm phẳng và hình ảnh bên ngoài bị bỏ qua vì quyền riêng tư.
Your file is ready
Processed entirely in your browser — the file never left your device.
Cách chuyển Markdown sang PDF
Ba bước. Mọi thứ diễn ra trong trình duyệt của bạn.
Dán hoặc thả
Dán markdown của bạn vào ô nhập văn bản hoặc thả một tệp .md. Bản xem trước trực tiếp cho thấy kết quả sẽ trông như thế nào.
Chọn tùy chọn
Khổ giấy, hướng, cỡ phông chữ thân bài và kiểu khối mã. Các giá trị mặc định phù hợp với hầu hết các README.
Tạo và tải xuống
marked phân tích thành HTML, HTML được token hóa thành các khối và pdf-lib dàn trang chúng — tất cả ngay trong tab của bạn.
Vì sao dùng Markdown sang PDF trên imisspdf?
Nguồn ở lại trên máy của bạn
Markdown thường chứa ghi chú nội bộ, bản nháp bài đăng hoặc khóa API trong các khối mã. Không có gì được tải lên — mọi byte của quá trình đều chạy cục bộ.
Nhanh cho tài liệu kỹ thuật
Tiêu đề, danh sách và mã được rào kết xuất gọn gàng ngay trong một lần nhìn. Không có hộp thoại in, không có chụp màn hình Chrome — dán, nhấn và tải xuống.
Tương thích với GFM
Gạch ngang chữ, danh sách công việc, khối mã được rào, liên kết tự động — trình phân tích là marked ở chế độ GFM. Bảng bị làm phẳng (chúng tôi nói trước).
"Markdown sang PDF" ở đây nghĩa là gì
Markdown là định dạng mà phần lớn lập trình viên và người viết tài liệu kỹ thuật thực sự soạn thảo — các tệp README, bản nháp blog, runbook, tài liệu API, wiki nội bộ. Nó nhẹ, có thể quản lý phiên bản và kết xuất gọn gàng trên GitHub. Nhưng khi đến lúc chia sẻ tài liệu đó với ai đó không làm việc trong kho lưu trữ của bạn, PDF thường là định dạng bàn giao phù hợp: nó in ra một cách có thể dự đoán, mở được trên mọi thiết bị và không phụ thuộc vào việc người nhận có cài sẵn trình xem markdown hay không.
Công cụ Markdown sang PDF của imisspdf lấy nguồn markdown bạn dán vào (hoặc thả dưới dạng tệp .md) và tạo ra một PDF duy nhất ngay trong trình duyệt của bạn. Tiêu đề giữ nguyên thứ bậc, danh sách giữ thụt lề, các khối mã được rào kết xuất bằng phông đơn cách, còn trích dẫn / đường kẻ ngang trông đúng là trích dẫn và đường kẻ. Kết quả là một PDF sạch sẽ, không màu mè, phù hợp cho một README, một báo cáo kỹ thuật hoặc một nhật ký thay đổi bàn giao cho người đọc không chuyên về kỹ thuật.
Quá trình chuyển đổi hoạt động ra sao
Ba giai đoạn chạy từ đầu đến cuối ngay trong tab của bạn:
- Trình phân tích marked chuyển markdown của bạn thành HTML với các quy tắc GFM được bật (mã được rào, gạch ngang chữ, danh sách công việc, liên kết tự động).
- Một bộ token hóa nhỏ dựa trên biểu thức chính quy duyệt qua HTML và chuyển nó thành một chuỗi token khối phẳng — tiêu đề, đoạn văn, danh sách, khối mã, trích dẫn — cùng các đoạn nội dòng của chúng (đậm, nghiêng, mã nội dòng, liên kết).
- pdf-lib dàn các khối lên các trang bằng 14 phông chuẩn của PDF (Helvetica cho thân bài, Courier cho mã). Trang mới được thêm vào khi nội dung tràn xuống.
Không có gì trong quá trình này trao đổi với một máy chủ. Không có markdown được kết xuất từ xa, không có Chromium không giao diện khởi động trong một hàm đám mây, không có tệp tạm bị giữ lại "trong một giờ để tuân thủ quy định lưu giữ". PDF được dựng bằng các byte JavaScript mà bạn có thể xem chúng được ghi ra trong DevTools của mình.
Khi nào đây là công cụ phù hợp — và khi nào không
Công cụ này phù hợp khi bạn cần một PDF sạch sẽ, có thể lưu trữ của nội dung kỹ thuật: một README, một runbook, một báo cáo viết bằng markdown, ghi chú cuộc họp, một hướng dẫn. Nó xử lý định dạng nội dòng, danh sách, mã và trích dẫn đúng như bạn mong đợi đối với loại tài liệu đó.
Đây là công cụ không phù hợp khi bạn cần độ trung thực từng điểm ảnh với một trang đã kết xuất (hãy dùng tùy chọn Lưu thành PDF của trình duyệt trên trang đã kết xuất), khi bạn cần bảng theo kiểu sắp chữ (hãy dùng Pandoc + LaTeX cục bộ) hoặc khi bạn cần mã được tô màu cú pháp (hãy xuất từ trình soạn thảo của bạn dưới dạng HTML rồi dùng HTML sang PDF). Chúng tôi nêu rõ các giới hạn trước để bạn chọn đúng quy trình.
Quyền riêng tư và bảo mật
Markdown là một trong những định dạng dễ chứa những thứ bạn sẽ không muốn đặt lên một máy chủ nhất: khóa API trong các khối mã, URL nội bộ trong liên kết, bản nháp bài đăng bạn chưa công bố, tên khách hàng trong ghi chú cuộc họp. Các công cụ markdown-sang-PDF chạy trên máy chủ buộc phải nuốt hết tất cả những thứ đó. Kiến trúc của công cụ này có nghĩa là bạn không phải đặt niềm tin vào một chính sách quyền riêng tư — đơn giản là không có bước tải lên nào trong quá trình. Hãy chặn mạng của bạn lại và quá trình chuyển đổi vẫn hoạt động sau khi trang đã tải xong.
Câu hỏi thường gặp
Có — trình phân tích chạy ở chế độ GFM, nên các khối mã được rào bằng dấu (``` backtick), gạch ngang chữ (~~văn bản~~), danh sách công việc, liên kết tự động và quy tắc xuống đoạn nới lỏng của GFM đều hoạt động. Thứ duy nhất không sống sót qua quá trình chuyển đổi là bảng: marked tạo ra một <table> HTML, nhưng bộ kết xuất PDF trong công cụ này không vẽ ô bảng, nên bảng sẽ ra thành các dòng văn bản bị làm phẳng. Nếu README của bạn phụ thuộc nhiều vào bảng, hãy kết xuất trang trên GitHub trước rồi dùng HTML sang PDF hoặc chụp ảnh màn hình để có một lưới thực sự.
Không. Các khối mã được kết xuất bằng phông Courier có độ rộng cố định với một màu duy nhất để phần thụt lề và cấu trúc của mã vẫn dễ đọc, nhưng các token không được tô màu theo ngôn ngữ. Chúng tôi cố tình bỏ qua việc tô màu cú pháp vì nó sẽ buộc phải tải một thư viện tô màu hơn 200 KB lên một trang mà nhiệm vụ chính là chuyển sang PDF, và PDF thường được in hoặc lưu trữ — chứ không phải đọc như trong một IDE. Nếu bạn cần mã được tô màu, hãy dán HTML đã tô màu từ trình soạn thảo của bạn qua công cụ HTML sang PDF của chúng tôi.
Các thẻ hình ảnh bên ngoài () bị loại bỏ — công cụ sẽ không tải hình ảnh từ xa về. Đây là chủ ý vì hai lý do: quyền riêng tư (việc tải về sẽ rò rỉ IP và referer của bạn cho máy chủ chứa hình ảnh) và độ tin cậy (kết xuất phụ thuộc vào mạng cho ra kết quả không nhất quán). Nếu bạn cần nhúng hình ảnh vào PDF, hãy dùng công cụ JPG sang PDF hoặc PNG sang PDF để thêm chúng thành các trang riêng, hoặc ghép chúng với PDF được kết xuất từ markdown bằng Ghép PDF.
Không. Cả mã nguồn markdown lẫn PDF được kết xuất đều nằm hoàn toàn bên trong tab trình duyệt của bạn. Trình phân tích marked, bộ token hóa HTML-thành-khối và pdf-lib đều là JavaScript phía máy khách, được tải một lần trên trang này rồi chạy cục bộ. Bạn có thể tự kiểm chứng trong tab Network của DevTools trên trình duyệt — sau khi trang tải xong, việc tạo PDF không phát đi yêu cầu mạng nào ra ngoài. Đóng tab lại là mọi dấu vết biến mất; không có tệp tạm phía máy chủ vì chẳng có bước máy chủ nào cả.
Cả sáu cấp tiêu đề markdown (# đến ######) được kết xuất thành tiêu đề PDF với cỡ chữ giảm dần (h1 lớn nhất, h6 chỉ nhỉnh hơn văn bản thân bài một chút). Thứ bậc được giữ nguyên để trình đọc màn hình và trình đọc PDF nắm được dàn ý. Bên trong tiêu đề, định dạng nội dòng (đậm, nghiêng, mã nội dòng) được tôn trọng. Chúng tôi không tự động tạo mục lục — nếu tài liệu của bạn cần, hãy tự thêm một phần "## Mục lục" bằng một danh sách markdown đơn giản.
Không ở dạng lưới. marked phân tích bảng đúng thành HTML, nhưng bộ kết xuất PDF của chúng tôi được làm cố ý đơn giản và không vẽ viền ô hay phân bổ cột. Bảng sẽ ra thành một chuỗi dòng văn bản, từng hàng một, thường là không đọc nổi với bất cứ thứ gì hơn một ví dụ 2x2. Nếu bảng là thiết yếu cho tài liệu của bạn, quy trình trung thực là: kết xuất sang HTML trong trình xem ưa thích của bạn, chụp ảnh màn hình và dùng JPG sang PDF — hoặc dùng Pandoc cục bộ để có kết quả chất lượng LaTeX. Chúng tôi nói thẳng về giới hạn này thay vì giả vờ kết xuất bảng một cách tệ hại.
Mẹo để có kết quả tốt
- Dùng tiêu đề thực sự. Một dấu
#ở đầu dòng sẽ trở thành h1; các cấp thấp hơn lồng vào gọn gàng. Trình đọc PDF và trình đọc màn hình nắm được dàn ý. - Giữ các khối mã được rào. Các khối với ba dấu backtick được kết xuất bằng Courier, nhờ vậy thụt lề đọc đúng ngay cả khi xuống dòng.
- Tránh markdown nhiều hình ảnh. Hình ảnh bên ngoài không được tải về. Hãy chuyển hình ảnh sang PDF riêng rồi ghép chúng lại.
- Với bảng, hãy kết xuất markdown trong công cụ của bạn trước rồi chụp ảnh màn hình. Hoặc dùng Pandoc cục bộ cho bảng theo kiểu sắp chữ.
Công cụ PDF liên quan
- HTML sang PDF — cùng bộ kết xuất, với đầu vào HTML thay vì markdown.
- TXT sang PDF — văn bản thuần không có bất kỳ định dạng nào.
- Ghép PDF — kết hợp PDF từ markdown với hình ảnh hoặc tệp khác.
- Nén PDF — giảm kích thước kết quả để chia sẻ.