Công cụ chuyển đổi

Chuyển Markdown sang PDF

Chuyển Markdown sang PDF là công cụ in trên trình duyệt: dán Markdown, chọn khổ giấy và chủ đề, rồi dùng Print / Save as PDF. Tài liệu được in cục bộ và không có gì được tải lên.

# Quarterly Research Report

中文摘要 · 日本語要約 · 한국어 요약

This note mixes Latin, CJK, a table, math, and a code sample.

## Results

| Region | Revenue |
| --- | --- |
| 東京 | ¥12.4M |
| 서울 | ₩980M |
| 上海 | ¥9.1M |

The growth rate is $r = \frac{\Delta x}{x}$.

```python
def growth(previous: float, current: float) -> float:
    return (current - previous) / previous
```

Cách thực hiện

Cách chuyển Markdown sang PDF

Bạn có thể dán gì

Mọi Markdown: CommonMark cùng bảng, danh sách công việc và gạch ngang của GitHub Flavored Markdown
Kết xuất chạy trong trình duyệt — không có gì được tải lên khi bạn gõ
Không cần tài khoản để xem trước, sao chép hoặc tải xuống
Không có giới hạn kích thước cố định; một tài liệu rất lớn bị giới hạn bởi bộ nhớ trình duyệt

Chuyển Markdown sang PDF: trình soạn thảo Markdown bên trái thành trang PDF in bên phải

Vì sao nên dùng

Vì sao nên dùng công cụ chuyển Markdown sang PDF này

Một file Markdown không có hình học trang riêng. Công cụ này thêm khổ giấy, lề và quy tắc ngắt trang, rồi giao kết quả cho engine in của trình duyệt bạn.

In cục bộ, không tải lên gì

PDF đến từ engine in của trình duyệt. Markdown không bao giờ rời khỏi thiết bị của bạn.

Khổ giấy và lề

Chọn A4 hoặc Letter, dọc hoặc ngang, và lề thường, hẹp hoặc rộng trước khi in.

Chủ đề cho từng loại tài liệu

Các chủ đề github, document và compact thay đổi phông, khoảng cách và màu khối mã mà không đổi Markdown.

Số trang

Thêm số trang ở góc hoặc giữa mỗi trang in, được định kiểu khớp với chủ đề hiện tại.

Bộ phông hỗ trợ CJK

Stylesheet in liệt kê phông hệ thống Trung, Nhật, Hàn trước phông dự phòng Latin, cho các báo cáo trộn nhiều hệ chữ.

Cùng renderer HTML như API

Tài liệu được dựng từ cùng HTML đã khử trùng như POST /v1/convert/markdown/html, rồi bọc trong CSS in mà trình duyệt biến thành PDF.

Vấn đề

Vì sao Markdown cần quy tắc trang trước khi in

Markdown không có hình học trang

Một file Markdown mô tả tiêu đề và đoạn văn, không mô tả khổ giấy, lề, hay chỗ nào nên ngắt trang.

Bảng dài và khối mã bị cắt xấu

Không có quy tắc ngắt trang, một hàng bảng hay một khối mã có hàng rào có thể bị cắt đôi ở cuối một trang in.

CJK và hệ chữ trộn cần đúng phông

Văn bản Trung, Nhật và Hàn có thể rơi vào một ký tự thiếu hoặc hành vi ngắt dòng khác nhau giữa các trình duyệt và hệ điều hành.

Markdown sang PDF: văn bản sao chép lộn xộn bên cạnh cấu trúc Markdown gọn gàng

Những gì được giữ lại

Những gì công cụ chuyển Markdown sang PDF này giữ lại

Khổ trang và lề: Một quy tắc @page đặt khổ giấy (A4 hoặc Letter), hướng và lề trước khi trình duyệt mở hộp thoại in.Source: CSS Paged Media Module
Tiêu đề có thể bắt đầu trang mới: Tiêu đề cấp 1 có thể ngắt sang trang mới theo mặc định, để mỗi mục cấp cao nhất bắt đầu gọn gàng; tiêu đề đầu tiên của tài liệu thì không.Source: CSS Paged Media Module
Bảng và mã tránh ngắt giữa trang: Bảng và mã có hàng rào được đánh dấu để tránh ngắt bên trong, nên trình duyệt chuyển cả khối sang trang kế tiếp thay vì cắt nó.Source: CSS Paged Media Module
Số trang qua bộ đếm CSS: Số trang tùy chọn được tạo bằng bộ đếm trang CSS, đặt ở trái, giữa hoặc phải trong chân trang.Source: CSS Paged Media Module
Cùng HTML đã khử trùng như API: Tài liệu in được bắt đầu từ cùng HTML CommonMark và GFM đã khử trùng mà POST /v1/convert/markdown/html dùng.Source: CommonMark Spec

CSS in đứng sau công cụ chuyển Markdown sang PDF này· bảng định kiểu in của markitdown.ai: chủ đề github, A4, bật số trang

@page { size: A4 portrait; margin: 25mm; }@page { @bottom-center { content: counter(page); font-size: 10pt; color: var(--md-muted); } }h1 { break-before: page; }article.md-document > h1:first-child { break-before: auto; }table, pre { break-inside: avoid; }

Trường hợp sử dụng

Trường hợp sử dụng chuyển Markdown sang PDF

Ở bất cứ đâu một ghi chú Markdown cần trở thành một file phân trang mà ai đó mở được mà không cần trình đọc Markdown.

Báo cáo và ghi chú nghiên cứu

Biến một báo cáo Markdown thành PDF phân trang để chia sẻ với người không có trình đọc Markdown.

Tài liệu đa ngữ

In các ghi chú trộn hệ chữ Latin với văn bản Trung, Nhật hoặc Hàn bằng bộ phông hỗ trợ CJK.

Bản phát nhanh từ README

Tạo một bản in được của tài liệu hoặc README mà không cần cài công cụ PDF riêng.

Lưu trữ một ghi chú Markdown

Lưu một ảnh chụp phân trang, có ngày tháng của một ghi chú trước khi nó thay đổi thêm, mà không tải nó lên đâu cả.

Markdown sang PDF online: trang PDF in dùng làm báo cáo, để in và lưu trữ

Hướng dẫn

In từ trình duyệt

Công cụ này dựng một tài liệu in được trong trình duyệt và giao nó cho hộp thoại Print / Save as PDF của chính trình duyệt bạn. Tạo PDF phía máy chủ là kế hoạch nhưng chưa phát hành, nên API hiện không có endpoint PDF. Nếu hôm nay bạn cần một PDF từ một pipeline tự động, hãy kết xuất HTML đã khử trùng bằng POST /v1/convert/markdown/html và in HTML đó bằng một công cụ bạn kiểm soát, hoặc dùng trang này theo cách tương tác cho một tài liệu dùng một lần. Mục này sẽ được cập nhật nếu một endpoint máy chủ ra mắt; cho đến lúc đó, hãy coi đường in từ trình duyệt là tuyến duy nhất được hỗ trợ cho Markdown sang PDF trên sản phẩm này.

Giấy, lề, chủ đề

Khổ giấy và lề quyết định mỗi trang có bao nhiêu chỗ cho đoạn văn, bảng và mã: lề hẹp hơn chứa được nhiều hơn mỗi trang nhưng có thể chen chúc một bảng dày, còn lề rộng hơn đọc thoải mái hơn với cái giá là thêm trang. Ba chủ đề thay đổi phông, khoảng cách và nền khối mã mà không đụng vào chính Markdown, nên đổi chủ đề là cách an toàn để so sánh một ghi chú nội bộ gọn gàng với một tài liệu dành cho người đọc bên ngoài. Luôn kiểm tra bản xem trước đã phân trang sau một thay đổi, vì một thiết lập trông ổn trong một ghi chú ngắn có thể đẩy một bảng qua ngắt trang trong một báo cáo dài hơn.

A4 hợp với hầu hết độc giả ngoài Hoa Kỳ; Letter hợp với tài liệu hướng tới Hoa Kỳ.
Lề hẹp chứa nhiều nội dung hơn mỗi trang; lề rộng đọc thoải mái hơn.
Số trang giúp một báo cáo in ra, đóng ghim vẫn giữ đúng thứ tự.

Đa ngữ và mã

Markdown trộn văn bản Latin với ký tự Trung, Nhật hoặc Hàn phụ thuộc vào các phông thực sự được cài trên máy in nó, nên cùng một file có thể phân trang hơi khác nhau trên hai máy tính dù nguồn Markdown giống hệt. Hãy kiểm tra bản xem trước trên thiết bị bạn sẽ in, nhất là với một báo cáo dài nơi một ký tự thiếu có thể đẩy một tiêu đề sang sai trang. Khối mã và URL dài, không ngắt cũng hành xử tương tự: chúng được đánh dấu để tránh ngắt giữa dòng, nên trình duyệt chuyển cả khối sang trang kế tiếp thay vì cắt đôi một lệnh mà người đọc có thể muốn sao chép.

Thêm công cụ chuyển đổi Markdown

Need it in your code? Use the developer API. Converting at scale? See plans and pricing.

FAQ

Câu hỏi về Markdown sang PDF

Chuyển Markdown sang PDF có tải văn bản của tôi lên không?

Không. In cục bộ — không tải lên gì để tạo PDF; nó đến hoàn toàn từ engine in của trình duyệt bạn.

Có API Markdown sang PDF phía máy chủ không?

Chưa. POST /v1/convert/markdown/pdf không tồn tại, nên gọi nó trả về 404. Hãy kết xuất HTML bằng POST /v1/convert/markdown/html rồi in, hoặc dùng công cụ trên trang này.

Tôi có thể chọn A4 hay Letter không?

Có. Khổ giấy, hướng, lề và số trang đều là tùy chọn cục bộ trong trình soạn thảo.

Nó có xử lý văn bản Trung, Nhật hoặc Hàn không?

Stylesheet in liệt kê phông hệ thống CJK trước phông dự phòng Latin. Hãy kiểm tra bản xem trước đã phân trang trước khi in, vì phông có sẵn khác nhau theo thiết bị.

Tiêu đề có luôn bắt đầu một trang mới không?

Theo mặc định tiêu đề cấp 1 ngắt sang trang mới, trừ tiêu đề đầu tiên của tài liệu; có thể tắt tùy chọn này.

Tôi có cần tài khoản để in Markdown thành PDF không?

Không. Dán, xem trước và in đều hoạt động mà không cần đăng nhập.

Sau này có file PDF do máy chủ tạo không?

Tạo PDF phía máy chủ là kế hoạch. Hôm nay trang này dùng hộp thoại in của trình duyệt, và không có endpoint PDF phía máy chủ.

Chuyển Markdown sang PDF ở mọi nơi.

Dùng thử miễn phí — không cần đăng ký.

Bắt đầu Mở công cụ chuyển đổi