MarkdownCo

Markdown to Confluence Converter

Dán hoặc tải lên Markdown để nhận wiki markup của Confluence, dùng được ngay cho Data Center, Server hoặc Jira. Tiêu đề, bảng, khối code và liên kết được ánh xạ sang wiki markup tương ứng; công thức LaTeX được giữ nguyên không thay đổi.

Kết quả wiki markupCode macro kèm thẻ ngôn ngữCông thức LaTeX được giữ nguyên
document.md
confluence.txt

Confluence Wiki Markup

Kết quả cập nhật ngay khi bạn gõ. Bấm Convert & Download để lưu thành file.

Cách chuyển đổi Markdown sang Confluence

Từ file .md đến wiki markup sẵn sàng dùng cho Confluence chỉ trong ba bước.

1

Thêm nội dung Markdown

Dán Markdown vào trình soạn thảo hoặc kéo thả file .md.

2

Kiểm tra wiki markup

Bảng bên phải hiển thị wiki markup của Confluence ngay khi bạn gõ. Kiểm tra code macro và bảng trước khi xuất.

3

Chuyển đổi và tải xuống

Bấm Convert & Download để lưu wiki markup thành file .txt và giữ trong lịch sử chuyển đổi của bạn.

Wiki markup của Confluence dùng ở đâu

Wiki markup của Confluence là định dạng văn bản mà Confluence Data Center, Server và Jira đọc trực tiếp. Viết bằng Markdown và chuyển đổi khi xuất giúp giữ file gốc trong git trong khi cả nhóm vẫn đọc nội dung trên Confluence.

Confluence Data Center and Server pages
Trang Confluence Data Center và Server qua Insert > Markup
Jira descriptions and comments
Mô tả và bình luận trong Jira, vốn dùng chung wiki markup này
Bulk migration into Confluence
Di chuyển hàng loạt các repository README và tài liệu vào Confluence
Runbooks and technical notes
Xuất bản runbook và ghi chú kỹ thuật được viết bằng Markdown

Markdown của bạn được ánh xạ sang wiki markup Confluence như thế nào

Mỗi phần tử Markdown được ánh xạ sang phần tử wiki markup tương ứng, và quá trình chuyển đổi được kiểm thử trên các tài liệu kỹ thuật thực tế chứa nhiều code và công thức toán học.

Khối code trở thành code macro

Khối code có dấu backtick được chuyển thành macro {code:language=...} với thẻ ngôn ngữ được giữ nguyên, nhờ đó tô sáng cú pháp hoạt động đúng trong Confluence.

Code blocks become code macros

Bảng và liên kết chuyển đổi chính xác

Bảng GFM được ánh xạ sang dòng ||header|| và |cell|; liên kết [text](url) trở thành [text|url]. Danh sách lồng nhau giữ nguyên cấp độ.

Tables and links convert cleanly

Công thức LaTeX được giữ nguyên vẹn

Khối $$ và công thức inline $...$ được nhận diện và giữ nguyên như trong bản gốc — các lệnh căn khoảng cách, xuống dòng trong ma trận và dấu ngoặc nhọn có escape đều được giữ lại, để macro toán học phía Confluence có thể hiển thị chúng.

LaTeX math passes through untouched

Tiêu đề, trích dẫn và đường kẻ ánh xạ 1:1

Tiêu đề # trở thành h1. đến h6., trích dẫn khối trở thành khối {quote}, đường kẻ ngang trở thành ----. Cấu trúc tài liệu được giữ nguyên theo từng dòng.

Headings, quotes, and rules map 1:1

Câu hỏi thường gặp: Markdown to Confluence

Các câu trả lời này bao gồm kết quả wiki markup, code macro, xử lý công thức toán học và khả năng tương thích với Confluence Cloud.

Làm sao để chuyển đổi Markdown sang wiki markup Confluence?

Dán Markdown vào trình soạn thảo hoặc tải lên file .md. Bản xem trước wiki markup sẽ hiện ra ở bảng kết quả ngay khi bạn gõ. Để lấy kết quả, bấm Convert & Download — markup sẽ được lưu thành file .txt trong lịch sử chuyển đổi. Việc này cần đăng nhập và dùng credit; xem trang giá để biết chi tiết.

Công cụ này xuất ra định dạng nào?

Wiki markup của Confluence — cú pháp văn bản mà Confluence Data Center, Server và trình soạn thảo cũ đọc được (tiêu đề h1., *in đậm*, macro {code}, dòng ||table||). Đây cũng là họ markup mà Jira dùng trong mô tả và bình luận.

Kết quả có dùng được trên Confluence Cloud không?

Chỉ một phần. Trình soạn thảo mới của Confluence Cloud đã bỏ tùy chọn Insert > Markup, nên bạn không thể dán wiki markup vào đó. Wiki markup vẫn hoạt động trên Data Center, Server, trình soạn thảo cũ của Cloud và Jira. Nếu bạn đang dùng trình soạn thảo mới của Cloud, hãy dán Markdown trực tiếp — hầu hết cú pháp sẽ tự động chuyển đổi khi dán.

Khối code được chuyển đổi như thế nào?

Khối code có dấu backtick trở thành macro {code:language=...}. Định danh ngôn ngữ sau dấu backtick mở (```python, ```js) được đưa vào macro, nhờ đó Confluence áp dụng đúng kiểu tô sáng cú pháp. Khối không có thẻ ngôn ngữ sẽ trở thành {code:language=text}.

Công thức LaTeX sẽ ra sao?

Chúng được giữ nguyên từng byte. Bộ chuyển đổi nhận diện khối $$ và công thức inline $...$ trước khi chuyển đổi rồi khôi phục nguyên trạng sau đó, nên các lệnh căn khoảng cách như \, và xuống dòng trong ma trận \\ không bị lỗi. Confluence không có sẵn tính năng hiển thị công thức toán học — hãy kết hợp kết quả với một app macro LaTeX trên instance của bạn.

Công cụ có hỗ trợ bảng Markdown không?

Có. Bảng Markdown theo chuẩn GitHub (GFM) được chuyển sang markup bảng của Confluence: dòng tiêu đề trở thành ô ||header|| và dòng nội dung trở thành dòng |cell|. Cú pháp căn lề cột bị loại bỏ vì bảng trong wiki markup không hỗ trợ tính năng này.