Word đến Confluence Markdown: Nhập tài liệu vào Wiki Nhóm của bạn

Confluence là một trong những wiki nhóm được sử dụng rộng rãi nhất, và nhiều tổ chức có thư viện các tài liệu Word thuộc về Confluence. Chuyển đổi các tài liệu đó một cách sạch sẽ là khó khăn hơn so với nó Confluences Markdown hỗ trợ có quirks. Hướng dẫn này cho bạn thấy đáng tin cậy nhất Word đến Confluence quy trình làm việc.

Confluence có hỗ trợ Markdown không?

Confluence có hỗ trợ Markdown một phần, nhưng nó phụ thuộc vào việc thực hiện:

• Confluence Mây hỗ trợ macro Markdown và có thể hiển thị Markdown trong một số ngữ cảnh nhất định, nhưng trình soạn thảo bản địa là định dạng riêng của nó
• Confluence Data Center / Server cũng có macro Markdown
• Atlassian Rovo / Tác giả mới phiên bản mới hơn đã cải thiện Markdown hỗ trợ dán

Phương pháp đáng tin cậy nhất trên tất cả các phiên bản là chuyển đổi Word thành Markdown với WordToMD, sau đó dán nội dung Markdown bằng cách sử dụng tính năng nhập Confluences Markdown.

Phương pháp 1: Chèn Markdown thông qua Confluence Editor

Các bước

1. Chuyển đổi tài liệu Word của bạn tại WordToMD và nhấp vào Copy Markdown
2. Trong Confluence, mở trình chỉnh sửa trang
3. Từ menu Insert (+ icon), chọn Markup hoặc Other Macros → Markup
4. Chọn Markdown là ngôn ngữ
5. Chèn nội dung Markdown
6. Nhấp vào Insert

Khối macro Markup/Markdown hiển thị nội dung như văn bản phong phú trong trang. Nó không chuyển đổi thành các khối Confluence bản địa, nhưng nó hiển thị tiêu đề, bảng và danh sách một cách chính xác.

Phương pháp 2: Word nhập tệp

Confluence Cloud có tính năng nhập Word:

1. Tạo trang Confluence mới
2. Nhấp vào menu ... → Import Word Document
3. Chọn file .docx của bạn

Điều này hoạt động cho các tài liệu đơn giản nhưng có xu hướng mất định dạng phức tạp. Con đường Markdown cho phép kiểm soát nhiều hơn.

Phương pháp 3: Chuyển đổi thành HTML

Một số nhóm thích HTML là định dạng trung gian vì Confluences editor chấp nhận HTML paste:

1. Chuyển đổi Word doc thành Markdown với WordToMD
2. Chuyển đổi Markdown thành HTML bằng cách sử dụng công cụ trực tuyến hoặc marked library
3. Chuyển sang Confluence Source Editor (Ctrl+Shift+D hoặc từ thanh công cụ)
4. Nhập HTML

Cách tiếp cận này bảo tồn định dạng phức tạp hơn nhưng là nhiều bước.

Phù hợp định dạng

Bàn xử lý

Word bảng chuyển đổi thành GFM đường viền WordToMD. Confluence’s Markdown macro renders these correctly:

| Project | Owner | Status |
|---|---|---|
| Website redesign | Alice | In progress |
| API migration | Bob | Complete |

Đối với các hoạt động bảng phức tạp hơn, xem Markdown Bảng: Hướng dẫn đầy đủ.

Mã khối trong Confluence

Confluence có macro Code Block riêng của nó cung cấp điểm nhấn cú pháp và số dòng. Sau khi nhập nội dung Markdown, bạn có thể muốn thay thế các khối mã từ macro Markdown bằng các macro Confluence Code Block bản địa để dễ đọc hơn:

1. Đạo sửa trang
2. Tìm phần mã
3. Nhập một mã khối macro
4. Thiết lập ngôn ngữ để làm nổi bật cú pháp
5. Nhập mã

Đề cập đến: Markdown Hướng dẫn khối mã cho tổng hợp tiêu chuẩn.

Atlassian Confluence và ADF

Confluence Cloud sử dụng bản địa Định dạng tài liệu Atlassian (ADF) một JSON sơ đồ cho nội dung phong phú. Các macro Markdown ngồi trên đầu của điều này. Đối với nhập khẩu theo chương trình, Confluence REST API chấp nhận ADF trực tiếp. Nếu bạn đang xây dựng một đường ống tự động, chuyển đổi Word → Markdown → ADF bằng cách sử dụng các thư viện có sẵn.

Đối với hầu hết các nhóm, quy trình làm việc thủ công đơn giản hơn và nhanh hơn.

Di chuyển thư viện tài liệu

Nếu bạn đang di chuyển hàng chục tài liệu Word sang Confluence:

1. Chuyển đổi tất cả các tập tin bằng cách sử dụng WordToMD (hoặc lô với Pandoc đối với khối lượng lớn)
2. Tạo một Confluence không gian và lên kế hoạch phân cấp trang
3. Nhập trang thành các phần, nhóm các tài liệu liên quan dưới các trang mẹ
4. Thêm Confluence đặc tính sau khi nhập: nhãn, hạn chế trang, @mentions

FAQ

Tôi có thể sử dụng Markdown một cách bản địa trong Confluence mà không có macro không? Trong một số cấu hình của Confluence Cloud với New Editor, bạn có thể gõ các phím tắt Markdown và chúng tự động chuyển đổi (e.g., gõ ## tạo ra H2). Nhưng để dán các tài liệu được chuyển đổi, macro Markdown là đáng tin cậy hơn.

Định dạng tiêu đề của tôi bị mất sau khi nhập tất cả mọi thứ trông giống như văn bản thân. Điều này thường có nghĩa là macro Markdown không hoạt động. Markdown phải nằm bên trong khối macro Markup/Markdown, không được dán như văn bản đơn giản vào trình soạn thảo tiêu chuẩn.

Các bảng đang hiển thị như là các ký tự ống thô. Vấn đề tương tự nội dung phải nằm trong macro Markdown, không phải trong trình soạn thảo văn bản tiêu chuẩn.

Có cách tự động để đồng bộ hóa các tài liệu Word với các trang Confluence không? Vâng công cụ như Confluences Tài liệu bên ngoài tính năng, Scroll Versions, hoặc kịch bản tùy chỉnh sử dụng Confluence REST API có thể đồng bộ hóa các tệp Markdown với các trang tự động.

Kết luận

Đơn giản nhất. Word đến Confluence dòng công việc là: chuyển đổi với WordToMD, sau đó nhập thông qua macro Markdown. Đối với các tài liệu phức tạp hoặc di chuyển hàng loạt, phương pháp tiếp cận trung gian HTML hoặc tự động hóa REST API cung cấp nhiều kiểm soát hơn. Dù bằng cách nào, việc sử dụng đúng các kiểu tiêu đề của Word trước khi chuyển đổi đảm bảo phân cấp trang không bị ảnh hưởng.