Chuyển đổi Markdown

Acrafto Team Văn bản
Cập nhật

Phần front matter ở đầu không được in ra. Tiêu đề “Báo cáo quý” của nó được dùng làm tiêu đề tài liệu.

Kết quả
Báo cáo quý

Tài liệu này cho thấy những gì bộ chuyển đổi giữ lại: tiêu đề, danh sách, bảng, mã, trích dẫn, liên kết và chú thích.1

Điểm nổi bật
  • Doanh thu tăng 12% so với quý trước
  • Hai thành viên mới gia nhập nhóm vào tháng Chín
  • Trang dự án có đầy đủ số liệu
Số liệu
Tháng Đơn hàng Thay đổi
Tháng Bảy 1.240 +4%
Tháng Tám 1.310 +6%
Tháng Chín 1.395 +6%
Bước tiếp theo
  1. Hoàn thiện hướng dẫn cho người mới
  2. Xem lại trang bảng giá
    • So sánh với phiên bản cũ
    • Hỏi bộ phận hỗ trợ để lấy ý kiến
  3. Lên kế hoạch cho bản phát hành tiếp theo
  • Thu thập dữ liệu
  • Gửi báo cáo

Số liệu được làm tròn đến đơn hàng gần nhất.

npm run build && npm run deploy

  1. Tiêu đề lấy từ phần front matter YAML ở đầu tài liệu, phần này không được in ra. ↩︎

Tùy chọn

Chuyển Markdown sang PDF, Word, HTML hoặc văn bản thuần bằng bộ chuyển đổi Markdown chạy ngay trong trình duyệt của bạn: dán văn bản hoặc mở tệp .md, chọn định dạng và tải kết quả xuống. Công cụ còn biến bảng Markdown thành tệp Excel hoặc CSV, tạo sách điện tử EPUB và tài liệu LaTeX, và viết lại Markdown cho Jira, Confluence, Slack và BBCode của diễn đàn. Bản xem trước cạnh văn bản cho thấy kết quả trong lúc bạn điều chỉnh thiết lập. Tệp của bạn không bị tải lên đâu cả, không cần đăng ký, không có hình mờ và không giới hạn số trang.

Cách chuyển đổi tệp Markdown

  1. Dán Markdown vào ô bên trái, hoặc nhấn Mở tệp và chọn một hay nhiều tệp .md. Bạn cũng có thể thả tệp vào bộ chuyển đổi.
  2. Chọn định dạng trong mục Chuyển sang. Nhóm Tài liệu gồm PDF, Word (DOCX), EPUB, LaTeX, HTML và Văn bản (TXT), nhóm Bảng gồm Excel (XLSX) và CSV, còn nhóm Cho ứng dụng gồm Jira / Confluence, Slack và BBCode.
  3. Kiểm tra bản xem trước ở mục Kết quả và, nếu muốn, đổi khổ giấy, lề, phông chữ hoặc các thiết lập khác trong Tùy chọn.
  4. Sửa Tên tệp nếu cần rồi nhấn nút tải xuống. Các định dạng văn bản cũng có thể sao chép thẳng vào bộ nhớ tạm, còn với Jira, Slack và BBCode, sao chép là nút chính.

Bộ chuyển đổi mở sẵn một báo cáo quý mẫu có tiêu đề trong front matter, danh sách, một bảng với các số căn phải, một danh sách công việc, một trích dẫn, một khối mã và một chú thích. Hãy chuyển nó sang từng định dạng để xem các thành phần hiện ra thế nào.

Chuyển Markdown sang PDF

Tệp PDF được tạo ngay trong trình duyệt với văn bản thật, có thể bôi đen được, không phải ảnh chụp màn hình của trang. Tiêu đề xuất hiện thành dấu trang (bookmark) ở bảng bên của trình đọc PDF, liên kết vẫn nhấp được, còn liên kết tới tiêu đề hoặc chú thích sẽ nhảy đến vị trí tương ứng trong tài liệu. Bảng giữ cách căn cột và lặp lại hàng tiêu đề trên mọi trang mà bảng trải qua, danh sách lồng nhau được đánh số 1., a., i. như trong Word, và danh sách công việc có ô đánh dấu được vẽ sẵn. Khối mã dùng phông chữ đơn cách trên nền xám nhạt, nên thụt lề được giữ đúng như khi viết.

Trong Tùy chọn, bạn chọn Khổ giấy (A4 hoặc Letter, được chọn sẵn theo ngôn ngữ của trình duyệt), Lề (hẹp 1,27 cm, bình thường 2,54 cm hoặc rộng 3,81 cm, tức 0,5, 1 hoặc 1,5 inch), Phông chữ có chân hoặc không chân, Cỡ chữ và có in Số trang hay không. Mục lục thêm danh sách các tiêu đề kèm số trang ngay sau tiêu đề tài liệu.

Phông chữ được nhúng trong tệp PDF, nên tài liệu trông giống nhau trên mọi máy tính và máy in. Chúng hỗ trợ chữ Latinh, chữ Kirin, chữ Hy Lạp và tiếng Việt, cùng mũi tên, ký hiệu toán học và các biểu tượng như → ≤ ✓ ★. Chữ Trung, Nhật, Hàn, Ả Rập, Do Thái, Thái, các hệ chữ Ấn Độ và emoji không có trong đó. Khi tài liệu dùng đến chúng, bộ chuyển đổi nêu tên các ký tự đó và nút tải xuống chuyển thành Lưu dưới dạng PDF: nút này mở hộp thoại in của trình duyệt, vốn dùng phông chữ của hệ thống và viết tiếng Ả Rập và tiếng Do Thái từ phải sang trái. Hãy chọn Lưu dưới dạng PDF làm máy in; khổ giấy, lề và phông chữ trong Tùy chọn vẫn được giữ nguyên.

Chuyển Markdown sang Word (DOCX)

Tệp Word có cấu trúc tài liệu thật, không chỉ là văn bản trông giống như vậy. Tiêu đề dùng các kiểu dựng sẵn Heading 1 đến Heading 6 (Đầu đề 1 đến Đầu đề 6 trong Word tiếng Việt), nên ngăn điều hướng trong Word liệt kê chúng và lệnh chèn mục lục tự động của Word tạo trang mục lục chỉ với một cú nhấp. Danh sách là danh sách Word thật, giữ đúng số thứ tự khi bạn thêm mục, mỗi danh sách đánh số bắt đầu lại từ 1 (hoặc từ số bạn đã viết), còn các mục công việc có ☐ và ☒. Bảng lặp lại hàng tiêu đề trên mỗi trang, chú thích trở thành chú thích cuối trang thật của Word, và liên kết tới tiêu đề sẽ nhảy đến tiêu đề đó.

Hãy chọn khổ giấy, lề, cỡ chữ và một trong các phông chữ chuẩn Calibri, Cambria, Arial hoặc Times New Roman. Word hiển thị tệp bằng phông chữ được cài trên máy tính mở nó, nên bản xem trước ở đây là hình mẫu gần đúng chứ không phải bản sao chính xác đến từng điểm ảnh. Tệp .docx mở được trong Microsoft Word, LibreOffice và các chương trình khác đọc định dạng Office Open XML. Để đưa Markdown vào Google Docs, hãy tải tệp .docx lên Google Drive rồi mở bằng Google Docs, hoặc dán nội dung bằng Sao chép có định dạng từ trình soạn thảo Markdown.

Chuyển Markdown sang HTML

Trang hoàn chỉnh kèm CSS cho bạn một tệp .html độc lập với bảng định kiểu gọn gàng của riêng nó. Tệp hoạt động cả khi không có mạng, theo chế độ sáng hoặc tối trên hệ thống của người đọc và in ra đẹp. Chỉ phần nội dung, cho CMS chỉ cho các phần tử HTML (<h2>, <p>, <ul>, <table> và các phần tử khác) mà không kèm định kiểu nào, sẵn sàng để dán vào WordPress, Ghost, công cụ gửi bản tin hoặc mẫu của riêng bạn. Chuyển bản xem trước giữa Hiển thị và Mã để xem cả hai.

HTML tuân theo CommonMark và GitHub Flavored Markdown (cả hai bằng tiếng Anh). Tiêu đề nhận thuộc tính id như trên GitHub, nên các liên kết như #kế-hoạch-phát-hành vẫn hoạt động, và chú thích có liên kết quay lại chỗ đã trích dẫn chúng. Script, trình xử lý sự kiện và liên kết javascript: bị loại khỏi mọi đoạn HTML thô trong mã nguồn, nên tệp Markdown của người khác không thể lén chèn mã vào trang của bạn.

Chuyển Markdown sang văn bản thuần

Văn bản (TXT) loại bỏ cú pháp Markdown và giữ cấu trúc dễ đọc: dấu đầu dòng thành “- ”, mục đánh số giữ số của mình, mục công việc hiện dạng [ ] và [x], trích dẫn bắt đầu bằng “> ”, bảng được căn thẳng theo cột và chú thích được liệt kê dạng [1], [2] ở cuối. Giữ địa chỉ liên kết ghi URL trong ngoặc sau mỗi liên kết, nên không mất gì khi văn bản được đưa vào email, ô biểu mẫu hoặc hệ thống không hiểu Markdown. Độ dài dòng có thể ngắt các dòng dài ở 72 hoặc 80 ký tự cho email dạng văn bản thuần.

Điều này cũng tiện cho câu trả lời từ các công cụ chat AI, vốn được viết bằng Markdown: chuyển chúng sang văn bản sẽ xóa các dấu sao và dấu thăng trước khi bạn dán sang nơi khác.

Chuyển bảng Markdown sang Excel và CSV

Excel (XLSX) và CSV chỉ lấy các bảng trong tài liệu, rất tiện cho bảng trong tệp README, tài liệu kỹ thuật hoặc câu trả lời của công cụ chat AI. Trong Excel, mỗi bảng thành một trang tính riêng mang tên tiêu đề phía trên nó. Số được lưu thành số thật, kể cả số có dấu phân cách hàng nghìn như 1.240 và phần trăm như 12%, nên bạn có thể tính tổng và sắp xếp ngay, còn các giá trị như 007 hoặc mã bưu chính giữ nguyên số 0 ở đầu dưới dạng văn bản. Hàng tiêu đề được in đậm và cố định, và mỗi trang tính có sẵn bộ lọc.

CSV ghi mỗi bảng thành một tệp, nhiều bảng được nén vào một tệp ZIP. Trong Tùy chọn, bạn chọn Dấu phân cách: nếu Excel được đặt theo một ngôn ngữ dùng dấu phẩy thập phân, như tiếng Đức hoặc tiếng Pháp, thì cần dấu chấm phẩy, nếu không cả hàng sẽ dồn vào một cột. Tương thích Excel (UTF-8 có BOM) giúp Excel đọc đúng chữ có dấu và các ký tự khác. Sao chép bảng đưa các bảng vào bộ nhớ tạm để bạn dán vào Excel hoặc Google Sheets mà không cần lưu tệp.

Chuyển Markdown sang Jira, Confluence, Slack và BBCode

Ba định dạng này là văn bản cho những ứng dụng không đọc Markdown chuẩn, nên nút chính sẽ sao chép kết quả:

  • Jira / Confluence viết wiki markup: tiêu đề h2., *bold*, _italic_, khối {code}, bảng ||header||, liên kết [text|url] và danh sách # hoặc *. Định dạng này dành cho Jira và Confluence Data Center hoặc Server, và cho các trường cũ vẫn dùng wiki markup. Trình soạn thảo hiện tại của Jira Cloud tự đọc Markdown, nên ở đó bạn có thể dán văn bản gốc.
  • Slack viết cú pháp riêng của Slack: *bold*, _italic_, ~strikethrough~, mã, trích dẫn và liên kết [text](url), danh sách dùng ký tự dấu đầu dòng và bảng thành khối mã căn thẳng, vì Slack không có bảng. Hãy bật Format messages with markup trong Preferences, Advanced của Slack để thấy định dạng sau khi gửi. Cho bot và webhook (định dạng API) viết liên kết dạng <url|text> và escape &, < và >, đúng như Slack API yêu cầu.
  • BBCode dùng các thẻ mà phpBB, vBulletin, XenForo, SMF và MyBB đều hiểu: [b], [i], [u], [s], [url], [img], [quote], [list] và [code]. Tiêu đề thành dòng in đậm, vì cỡ tiêu đề mỗi diễn đàn một khác, còn bảng thành khối [code] căn thẳng.

Chuyển Markdown sang EPUB cho máy đọc sách và Kindle

EPUB tạo một cuốn sách điện tử có trang tiêu đề, mục lục và mỗi tiêu đề cấp cao nhất là một chương. Khi tài liệu chỉ có một tiêu đề cấp 1 dùng làm tên sách, chương sẽ bắt đầu từ tiêu đề cấp 2; Chương mới bắt đầu ở trong Tùy chọn cho phép bạn tự chọn. Chú thích được gom thành chú thích cuối sách có liên kết quay lại văn bản, hình ảnh có địa chỉ web được nhúng vào, còn tiêu đề và tác giả trong front matter xuất hiện trong thông tin của sách.

Tệp vượt qua EPUBCheck (bằng tiếng Anh), trình kiểm tra EPUB chính thức, nên mở được trong Apple Books, Kobo, Google Play Sách và Calibre. Send to Kindle của Amazon cũng nhận EPUB và chuyển đổi cho Kindle của bạn, còn Kindle Direct Publishing nhận bản thảo EPUB, với ảnh bìa được tải lên riêng.

Chuyển Markdown sang LaTeX

LaTeX tạo một tài liệu article hoàn chỉnh chỉ nạp những gói cần thiết, hoặc với Chỉ phần nội dung, để dán vào tài liệu chỉ tạo phần nội dung cho một bài viết bạn đã có, chẳng hạn trong Overleaf. Tiêu đề thành \section và \subsection, danh sách thành itemize và enumerate, bảng thành tabular giữ nguyên cách căn cột, mã được đặt trong verbatim, chú thích thành lệnh \footnote thật và liên kết dùng \href. Các ký tự mà LaTeX coi là lệnh, như %, $, &, # và _, đều được escape. LaTeX không tải được hình ảnh từ web, nên mỗi hình ảnh thành một dòng \includegraphics với tên tệp, kèm địa chỉ gốc trong một dòng comment; hãy tải hình ảnh về và đặt cạnh tệp .tex. Biên dịch bằng pdfLaTeX, hoặc bằng XeLaTeX hay LuaLaTeX cho các hệ chữ không phải Latinh.

Chuyển đổi nhiều tệp .md cùng lúc

Mở hoặc thả nhiều tệp, một danh sách sẽ hiện ra bên dưới ô văn bản. Chỉnh sửa nạp một tệp vào ô để bạn kiểm tra hoặc sửa, Gỡ bỏ đưa tệp ra khỏi lô, còn Tải xuống tất cả dạng ZIP chuyển mọi tệp sang định dạng đã chọn với cùng thiết lập. Mỗi tệp giữ tên của mình, nên notes.md thành notes.pdf. Các tệp không phải văn bản, chẳng hạn hình ảnh, sẽ bị bỏ qua kèm thông báo.

Front matter, hình ảnh và tên tệp

Nhiều tệp Markdown bắt đầu bằng một khối YAML front matter (bằng tiếng Anh) nằm giữa hai dòng ---, như Jekyll, Hugo, Obsidian và các công cụ khác vẫn dùng. Bộ chuyển đổi không in khối này ra. title của nó trở thành tiêu đề tài liệu trong thuộc tính của tệp PDF và Word và trong thẻ <title> của HTML, đồng thời là tên tệp được đề xuất; author trở thành tác giả. Khi không có front matter, tiêu đề cấp cao nhất đầu tiên sẽ đặt tên cho tệp.

Hình ảnh có địa chỉ web đầy đủ được trình duyệt tải xuống và nhúng vào tệp PDF và Word, miễn là máy chủ lưu trữ chúng cho phép (CORS, bằng tiếng Anh). Ảnh GIF, WebP và SVG được chuyển sang PNG trong quá trình này.

Câu hỏi thường gặp

Tệp Markdown của tôi có bị tải lên máy chủ không?

Không. Việc đọc tệp, tạo tài liệu PDF và Word và nén ZIP đều diễn ra trong trình duyệt của bạn, nên ghi chú riêng tư và tài liệu nội bộ không bao giờ rời khỏi máy tính. Bộ chuyển đổi chỉ ghi nhớ thiết lập của bạn, như định dạng và khổ giấy, chứ không ghi nhớ văn bản.

Tại sao hình ảnh bị thiếu trong tệp PDF của tôi?

Hình ảnh được ghi dưới dạng đường dẫn trên máy tính của bạn, như images/chart.png, thì một trang web không đọc được; chúng được thay bằng phần mô tả. Hãy dùng địa chỉ https đầy đủ, hoặc đưa hình ảnh lên mạng trước. Một số website cũng chặn trang khác tải hình ảnh của họ, khi đó phần mô tả cũng được dùng, và bộ chuyển đổi cho bạn biết có bao nhiêu hình ảnh không tải được.

Có thể chuyển Markdown chứa chữ Trung, Nhật hoặc Ả Rập sang PDF không?

Có, thông qua trình duyệt. Phông chữ tích hợp trong PDF không chứa các hệ chữ này, nên với tài liệu như vậy, nút tải xuống chuyển thành Lưu dưới dạng PDF và mở hộp thoại in, nơi bạn chọn Lưu dưới dạng PDF làm máy in. Trình duyệt dùng phông chữ của hệ thống, văn bản vẫn bôi đen được và tiếng Ả Rập hay tiếng Do Thái được viết từ phải sang trái. Word (DOCX) và HTML cũng giữ mọi ký tự.

Có hỗ trợ công thức toán LaTeX hoặc sơ đồ Mermaid không?

Không. Công thức viết giữa các dấu đô la vẫn là văn bản thường, còn khối Mermaid được chuyển đổi như mọi khối mã khác. Bảng, danh sách công việc, chú thích, mã và mọi thứ khác của GitHub Flavored Markdown đều được hỗ trợ trong mọi định dạng.

Có thể chuyển Word hoặc Google Docs sang Markdown không?

Có, bằng trình soạn thảo Markdown: dán văn bản sao chép từ Word, Google Docs hoặc một trang web và định dạng của nó sẽ chuyển thành Markdown, kể cả tiêu đề, danh sách, liên kết và bảng. Chuyển PDF ngược lại sang Markdown thì không được hỗ trợ, vì PDF lưu văn bản được đặt trên trang chứ không lưu tiêu đề, danh sách và bảng.

Làm sao để chuyển bảng Markdown sang Excel?

Dán Markdown có bảng, chọn Excel (XLSX) và tải tệp xuống. Mỗi bảng thành một trang tính, với số được lưu dưới dạng số. Nếu bạn chỉ cần các giá trị trong một bảng tính đang mở, hãy nhấn Sao chép bảng rồi dán vào Excel hoặc Google Sheets.

Tại sao Excel dồn cả một hàng CSV vào một cột?

Excel tách tệp CSV theo dấu phân cách danh sách của hệ thống. Ở các ngôn ngữ viết số thập phân bằng dấu phẩy, như tiếng Đức, tiếng Pháp hoặc tiếng Séc, dấu phân cách đó là dấu chấm phẩy. Hãy chọn Dấu chấm phẩy trong Dấu phân cách rồi tải xuống lại. Nếu chữ có dấu hiển thị sai, hãy để Tương thích Excel (UTF-8 có BOM) ở trạng thái bật.

Có thể gửi tệp EPUB sang Kindle không?

Có. Send to Kindle của Amazon, qua email, trong ứng dụng Kindle hoặc trên trang web Send to Kindle, nhận tệp EPUB và chuyển đổi chúng cho thư viện Kindle. Kindle Direct Publishing cũng nhận EPUB nếu bạn muốn xuất bản sách.

Jira Cloud còn dùng wiki markup không?

Trình soạn thảo hiện tại thì không, nó đọc Markdown và chuyển thành định dạng khi bạn dán hoặc gõ. Định dạng Jira / Confluence dành cho Jira và Confluence Data Center hoặc Server, và cho các trường cũ vẫn hiển thị wiki markup. Trong Jira Cloud, bạn có thể dán thẳng Markdown gốc.

Có thể mở tệp LaTeX trong Overleaf không?

Có. Tạo một dự án trống mới, tải tệp .tex lên hoặc dán nội dung của nó, rồi tải lên các hình ảnh mà tệp nhắc đến. Với Chỉ phần nội dung, để dán vào tài liệu, bạn chỉ nhận phần nội dung cho một dự án đã có phần mở đầu (preamble) riêng.

Làm sao để chuyển Markdown sang PDF hoặc Word bằng dòng lệnh?

Công cụ thường dùng là Pandoc (bằng tiếng Anh): pandoc notes.md -o notes.docx tạo ngay một tệp Word, còn xuất PDF thì cần cài thêm một trình biên dịch LaTeX. Trang này không cần cài đặt và cho bạn xem trước, dễ hơn khi làm với một tài liệu hoặc một lô nhỏ.

Có giới hạn kích thước tệp hoặc số trang không?

Mỗi tệp có thể chứa tới 20 MB văn bản, nhiều hơn rất nhiều so với bất kỳ tài liệu thông thường nào, và không có giới hạn số trang hay hình mờ. Tài liệu rất dài có nhiều hình ảnh cần vài giây để tạo, vì mọi việc đều do chính máy tính của bạn thực hiện.

Để viết hoặc sửa Markdown trước, hãy dùng trình soạn thảo Markdown có xem trước trực tiếp; nút Thêm tùy chọn xuất của nó mở bộ chuyển đổi này với văn bản đã được điền sẵn. Các công cụ khác cho văn bản nằm trong mục Văn bản, chẳng hạn công cụ đếm từ và ký tự và công cụ so sánh hai văn bản.

Tôi sẽ đánh giá cao nếu bạn có thể chia sẻ những trang này với bạn bè, đánh dấu trang hoặc liên kết đến chúng. Cảm ơn! 🙏