Xuất Obsidian sang Word: Hướng dẫn thực chiến 2026

Vault Obsidian được chuyển thành tài liệu Microsoft Word giữ nguyên định dạng

Nếu bạn sống trong Obsidian, chắc bạn cũng đã gặp cảnh này rồi. Bạn dành ba tháng xây dựng một ghi chú nghiên cứu với đầy đủ cú pháp riêng của Obsidian — kiểu như:

[[Project Plan]]        → liên kết sang ghi chú khác
![[diagram.png]]        → ảnh nhúng
> [!note] Key insight   → khối callout

Rồi đồng nghiệp hỏi xin bản Word — và mọi thứ không thuộc chuẩn Markdown đều vỡ tan.

Lần đầu tiên tôi gặp vấn đề này là khi phải bàn giao một bản nghiên cứu kỹ thuật 40 trang cho một stakeholder không chịu mở Obsidian. Bản trông đẹp long lanh trong vault khi sang Word lại biến thành mớ dấu ngoặc vuông trần trụi và những placeholder ảnh mồ côi. Sau lần đó và nhiều lần chuyển đổi khác, tôi đã chốt được một quy trình thực sự chạy ổn. Bài viết này ghi lại chính quy trình đó — bước tiền xử lý mà hầu hết mọi người bỏ qua, ba đặc thù của Obsidian thực sự quan trọng, và nên làm gì khi ảnh hay callout không chịu hợp tác.

Vì sao Markdown của Obsidian không "mang đi được" (và cái gì sẽ vỡ)

Obsidian lưu ghi chú dưới dạng file .md thuần, nên nhiều người nghĩ rằng xuất sang Word là chuyện đơn giản. Thực tế không phải vậy — bởi Obsidian mở rộng Markdown chuẩn bằng những tính năng mà không trình chuyển đổi chung nào hiểu được.

So sánh song song cú pháp Markdown đặc trưng của Obsidian và đầu ra CommonMark chuẩn

Đây là bốn phần mở rộng gây ra gần như toàn bộ ca xuất thất bại:

Cú pháp Obsidian	Ý nghĩa	Kết quả trong Word
`[[Project Plan]]`	Wikilink sang ghi chú khác	Hiện nguyên văn `[[Project Plan]]`
`![[diagram.png]]`	Tệp đính kèm nhúng	Hiện thành text, ảnh bay màu
`> [!warning] Title`	Khối callout	Biến thành blockquote thường, mất tiêu đề
`dataview` code block	Kết quả truy vấn động	Xuất ra code truy vấn, không phải bảng đã render

Các trình chuyển đổi Markdown chuẩn — Pandoc, phần lớn công cụ online — coi [[...]] là text thuần và ![[...]] là token không nhận diện được. Giao diện đã render trong Obsidian mà bạn nhìn thấy chỉ là preview, không phải mã nguồn. Sự nhầm lẫn giữa hai thứ này mới là gốc rễ của hầu hết cơn bực mình kiểu "sao bản xuất lại hỏng thế này".

Còn một vấn đề tinh tế hơn nữa: đường dẫn tệp đính kèm. Obsidian giải quyết ![[image.png]] bằng cách tìm kiếm tệp khớp tên trong vault, bất kể nằm ở thư mục nào. Markdown chuẩn thì cần đường dẫn tương đối rõ ràng. Nếu vault của bạn lưu tệp đính kèm ở 99 Attachments/ còn ghi chú lại ở 10 Projects/, link ảnh bắt buộc phải được viết lại trước khi trình chuyển đổi nào đó có thể tìm ra.

Trước khi xuất: bước tiền xử lý cứu bạn khỏi hàng giờ dọn dẹp

Bước cải thiện độ tin cậy lớn nhất trong quy trình của tôi đến từ việc dành 5 phút tiền xử lý trước khi chạy bất kỳ trình chuyển đổi nào. Bỏ bước này là bạn sẽ mất 30 phút dọn dẹp file Word sau đó.

Cấu trúc vault Obsidian với thư mục ghi chú và thư mục tệp đính kèm được tổ chức rõ ràng

Bước 1: Kiểm tra cài đặt tệp đính kèm

Mở Settings → Files and links. Ghi nhớ hai giá trị:

Default location for new attachments — nơi lưu ảnh/PDF mới
New link format — cách Obsidian viết đường dẫn (Shortest path when possible, Relative path to file, hay Absolute path in vault)

Nếu giá trị đang là Shortest path when possible (mặc định của Obsidian), bản xuất sẽ vỡ với bất kỳ ghi chú nào có tệp đính kèm không nằm cùng thư mục. Trước khi xuất, hãy chuyển sang Relative path to file. Thiết lập này chỉ áp dụng về sau — các link cũ vẫn giữ format ban đầu cho tới khi được viết lại. Bước 2 dưới đây sẽ lo phần viết lại.

Bước 2: Chuyển wikilinks sang link Markdown chuẩn

Obsidian có sẵn một toggle cho việc này: Settings → Files and links → Use [[Wikilinks]] → OFF. Khi tắt, link mới sẽ được viết dưới dạng [Note Name](Note-Name.md). Nhưng tùy chọn này chỉ ảnh hưởng tới link mới.

Để chuyển các [[wikilinks]] đã có trong một ghi chú, bạn có hai lựa chọn:

Làm thủ công cho file nhỏ — Cmd/Ctrl+F trong ghi chú, tìm từng [[, viết lại. Ổn cho ghi chú 5 trang.
Dùng community plugin cho vault lớn — mở Settings → Community plugins và tìm các từ khóa như "link converter" hay "markdown links". Có vài plugin trong hệ sinh thái hỗ trợ chuyển hàng loạt wikilinks (và cả ![[...]] đính kèm) sang cú pháp Markdown chuẩn, áp dụng cho file hiện tại hoặc cả thư mục. Chọn plugin được cập nhật gần đây và có lượt dùng đáng tin cậy.

Sau khi viết lại, các tệp đính kèm của bạn sẽ có dạng ![image.png](path/to/image.png). Kiểm tra output — nếu tên thư mục chứa khoảng trắng, hãy URL-encode chúng (My%20Vault/attachment.png) nếu không trình chuyển đổi sẽ lặng lẽ bỏ qua ảnh.

Bước 3: Quyết định sẽ làm gì với callout

Callout của Obsidian (> [!note], > [!warning], v.v.) rất giá trị trong vault nhưng không có tương đương trong Word. Bạn có ba lựa chọn, xếp theo mức độ công sức:

Chấp nhận xuống cấp — chúng sẽ render thành blockquote thường. Loại callout (note/warning/tip) bị mất, nhưng nội dung vẫn còn. Chấp nhận được cho hầu hết các ca bàn giao.
Viết lại những cái quan trọng — thay > [!warning] Critical bằng > **⚠️ Critical:** trước khi xuất. Dễ đọc ở cả hai nơi.
Hậu xử lý trong Word — chuyển blockquote thành hộp có style qua Quick Styles của Word. Chỉ đáng làm với tài liệu cần chỉn chu cao.

Tôi dùng tùy chọn 2 cho mọi thứ dưới 20 trang và tùy chọn 1 cho phần còn lại.

Bước 4: Xuất khối Dataview thành nội dung tĩnh

Nếu ghi chú chứa truy vấn Dataview, chúng sẽ xuất ra mã truy vấn, không phải bảng kết quả. Trước khi xuất, chạy truy vấn trong Obsidian, copy output đã render, rồi paste vào làm bảng Markdown tĩnh thay cho khối code. Đúng, bước này thủ công. Và không, không có cách nào sạch đẹp hơn — Dataview render ở phía client, nên file nguồn đơn giản là không chứa dữ liệu.

Quy trình xuất bốn bước

Sơ đồ quy trình bốn bước: vault Obsidian tiền xử lý, xuất Markdown, trình chuyển đổi, tinh chỉnh tài liệu Word

Xong tiền xử lý, phần chuyển đổi thật sự khá đơn giản.

1. Copy ghi chú ra ngoài (đừng xuất tại chỗ)

Nhân bản ghi chú đích và các tệp đính kèm của nó vào một thư mục tạm nằm ngoài vault. Bạn không muốn các chỉnh sửa tiền xử lý (viết lại link, thay thế callout) làm bẩn vault chính. Tôi để sẵn một thư mục _export-staging/ trên desktop cho việc này.

2. Làm phẳng đường dẫn tệp đính kèm

Dời toàn bộ ảnh được tham chiếu vào cùng thư mục với file .md rồi cập nhật link thành tên tệp đơn giản: ![diagram](diagram.png) thay vì ![diagram](../../99 Attachments/diagram.png). Hầu hết trình chuyển đổi gặp khó khi đường dẫn đi lên nhiều cấp thư mục.

3. Chạy trình chuyển đổi

Tải file .md đã tiền xử lý lên trình chuyển đổi Markdown sang Word của MarkFlow. Nó xử lý GitHub Flavored Markdown (GFM) — gồm bảng, danh sách công việc và footnote — đủ cho mọi tính năng chuẩn mà Obsidian sinh ra sau khi tiền xử lý. Ảnh được nhúng inline, khối mã giữ nguyên highlight cú pháp, và heading map sang Heading style của Word để Navigation Pane hoạt động đúng trong DOCX đầu ra.

Nếu ghi chú có công thức LaTeX ( $E=mc^2$ hoặc $$...$$), hãy xác nhận trình chuyển đổi bạn chọn giữ chúng dưới dạng equation của Word chứ không làm phẳng thành text thường. Với ghi chú nặng công thức — nhật ký nghiên cứu, bản thảo học thuật — đây là tính năng quyết định sống còn. Nếu Word không phải đích cuối cùng và bạn chỉ cần một file dễ chia sẻ, chuyển Markdown sang PDF sẽ né được hẳn mớ rắc rối về render phương trình của Word.

4. Tinh chỉnh trong Word

Mở DOCX và áp dụng template Word nếu bạn có sẵn. Heading style từ Markdown map gọn gàng sang Heading 1/2/3 của Word, nên đổi style toàn tài liệu chỉ là thao tác một cú click qua Design → Document Formatting. Kiểm ba điểm trước khi gửi đi:

Mục lục — chèn một cái qua References → Table of Contents để kiểm tra mọi heading đã được nhận đúng
Kích thước ảnh — Obsidian hiển thị ảnh ở kích thước tự nhiên, Word có thể phóng to chúng. Chọn tất và resize nếu cần
Siêu liên kết — link ngoài phải còn sống; [[wikilinks]] nội bộ hoặc đã được giải quyết, hoặc nên xóa bỏ

Các tình huống đặc thù của Obsidian

Một vài kịch bản xuất hiện đủ thường xuyên để đáng nhắc riêng.

Daily note và template

Nếu bạn đang xuất một daily note có dùng {{date}} hay biến templater, việc xuất diễn ra sau khi Obsidian đã thay thế chúng — nên file .md xuất ra chứa ngày thật, không phải placeholder. Không cần xử lý gì đặc biệt. Ngoại lệ là trường hợp bạn xuất trực tiếp từ filesystem mà chưa mở ghi chú trong Obsidian; template chưa được giải quyết sẽ lọt ra ngoài. Mở ghi chú trước, để Obsidian render xong, rồi hãy xuất.

File Canvas

File canvas của Obsidian (.canvas) là JSON, không phải Markdown, và không trình chuyển đổi Markdown nào đụng vào được. Với canvas, cách làm khả dĩ là chụp màn hình canvas ở mức zoom bạn muốn, lưu thành PNG, rồi nhúng ảnh đó vào một ghi chú Markdown wrapper rồi đem đi xuất. Một số community plugin cũng có tính năng "export canvas as image" trực tiếp nếu bạn cần làm việc này đủ thường xuyên để đáng cài.

Sơ đồ Mermaid

Code block có tag mermaid sẽ render thành sơ đồ bên trong Obsidian. Phần lớn trình chuyển đổi Markdown-to-Word online hoặc render chúng thành ảnh (tốt) hoặc để nguyên code thô (tệ). MarkFlow render Mermaid thành SVG inline trước khi chuyển đổi, Word hiển thị nó như một ảnh có thể chỉnh sửa. Nếu trình chuyển đổi bạn chọn không hỗ trợ Mermaid, phương án dự phòng là xuất sơ đồ thành PNG từ view của Obsidian rồi thay code block bằng ảnh nhúng chuẩn.

Chú thích cuối trang

Tin mừng — cú pháp footnote của Obsidian ([^1] và định nghĩa [^1]: text) là GFM chuẩn và chuyển đổi rất sạch sang tính năng footnote có sẵn của Word. Không cần tiền xử lý.

Tag và frontmatter

Frontmatter YAML (khối --- ở đầu ghi chú) thường bị trình chuyển đổi cắt bỏ. Nếu frontmatter chứa thông tin người đọc cần (tác giả, ngày, trạng thái), hãy đưa nó vào phần thân thành đoạn văn chuẩn trước khi xuất. Tag inline dạng #project/research thường sống sót dưới dạng text thường — ổn trong đa số trường hợp, lấn cấn trong vài ca khác. Find-and-replace để xóa chúng nếu tài liệu Word sẽ được đọc bởi người không dùng Obsidian.

Khi chuyển đổi thủ công ăn đứt tự động hóa

Thành thật mà nói: với một ghi chú 2-3 trang định dạng đơn giản, quy trình nhanh nhất là copy từ reading view của Obsidian rồi paste vào Word. Reading mode của Obsidian render HTML, và Word paste HTML thành nội dung có định dạng với độ trung thực đáng ngạc nhiên. Bảng đi qua được, bold/italic sống sót, heading map đúng sang heading style của Word.

Cách paste từ reading view này thất bại ở ba chỗ:

Ảnh — chúng được paste dưới dạng tham chiếu liên kết tới file trong vault, sẽ hỏng ngay khoảnh khắc file rời khỏi máy bạn
Khối mã — syntax highlighting mất sạch, font monospace không nhất quán
Callout và Mermaid — hỏng y như lúc xuất chuẩn

Vậy nên: ghi chú ngắn không có code hay ảnh → paste. Mọi thứ dài hơn hoặc kỹ thuật → quy trình 4 bước ở trên.

Xử lý sự cố: làm gì khi mọi thứ vỡ

Đây là những kiểu lỗi tôi gặp thường xuyên nhất. Để tham khảo rộng hơn, hướng dẫn xử lý lỗi chuyển đổi Markdown đi qua 15 lỗi phổ biến rất chi tiết.

Ảnh biến mất trong file Word. Khoảng 80% sự cố là do đường dẫn. Kiểm tra mã nguồn .md — đường dẫn đính kèm có phải là tên tệp đơn giản (image.png) hay là đường dẫn phức tạp (../../99 Attachments/My Folder/image.png)? Làm phẳng chúng.

Bảng render thành một dòng lộn xộn. Nguồn của bạn đang dùng format bảng cũ của Obsidian hoặc số ký tự pipe không nhất quán. Mở .md bằng trình soạn thảo văn bản thuần và đảm bảo mọi hàng có cùng số pipe. Dòng phân cách header phải khớp: | --- | --- |.

Khối mã mất highlight theo ngôn ngữ. Kiểm tra xem fence đã có tag ngôn ngữ (ví dụ python, js, bash) ngay sau ba backtick mở chưa. Trình chuyển đổi dựa vào tag đó để áp dụng highlight; fence không có tag mặc định thành text thường.

Wikilinks vẫn hiện [[Note Name]] sau khi xuất. Tiền xử lý không chạy, hoặc chạy mà không bao phủ file này. Xác nhận Use [[Wikilinks]] đã được toggle off trong settings, rồi chạy lại plugin chuyển đổi đã cài ở Bước 2 chỉ với file cụ thể — đa số plugin hỗ trợ phạm vi một ghi chú thay vì cả vault.

Công thức toán hiện ra LaTeX thô. Trình chuyển đổi không hỗ trợ render công thức. Hoặc đổi trình chuyển đổi, hoặc chụp màn hình phương trình đã render trong Obsidian rồi nhúng dưới dạng ảnh — xấu nhưng chắc chắn.

Quy trình thực tế cho nhóm

Nếu bạn là người duy nhất dùng Obsidian trong nhóm mà nhóm cần file Word, hãy xây dựng một quy trình lặp lại được thay vì viết script xuất một lần. Phiên bản tôi dùng trong các dự án cộng tác:

Giữ một thư mục Exports/ riêng trong vault cho các ghi chú sẽ đi về Word
Trong thư mục đó, dùng link Markdown chuẩn ngay từ đầu ([text](note.md)) thay vì wikilinks — đỡ tiền xử lý
Chạy chuyển đổi theo lô hàng tuần cho bất kỳ ghi chú nào có thay đổi
Lưu DOCX đầu ra trên shared drive, không để trong vault

Mục tiêu là tách không gian suy nghĩ (vault chính với mọi sức mạnh đặc trưng của Obsidian) khỏi không gian giao hàng (thư mục Exports/ nói tiếng Markdown chuẩn). Tái cấu trúc theo kiểu tách đôi này tốn tôi một giờ lần đầu và tiết kiệm hàng giờ mỗi tháng kể từ đó.

Nếu bạn đang đi theo hướng ngược lại — viết bằng Markdown và muốn nắm được những phần căn bản — bài hướng dẫn cách viết Markdown đi qua những nền tảng làm mọi lần xuất trở nên mượt hơn. Còn để xem kỹ hơn phần chuyển đổi của đường ống, hướng dẫn đầy đủ Markdown sang Word đi qua các tính năng converter thực sự quan trọng với tài liệu phức tạp.

Lời kết

Sức mạnh thật sự của Obsidian nằm ở những tính năng phi chuẩn — wikilinks, callout, truy vấn động — chính là thứ làm cho một vault sống động. Xuất sang Word nghĩa là phải từ bỏ phần lớn trong số đó. Bí quyết là đừng chống lại: chấp nhận rằng bản Word sẽ là một biểu diễn đã bị làm phẳng, tiền xử lý cho phù hợp, và dùng công cụ styling của Word để dựng lại độ chỉn chu ở chỗ cần thiết.

Khi thói quen tiền xử lý đã vào guồng, toàn bộ đường ống tốn khoảng năm phút cho mỗi ghi chú. Đó chính là khác biệt giữa "để lát nữa làm" và thật sự gửi tài liệu đi hôm nay.