Word to Confluence Markdown: นําเอกสารเข้า Wiki ทีมของคุณ

Confluence เป็น wiki ทีมที่ใช้ได้อย่างกว้างขวางที่สุด และองค์กรหลายองค์กรมีห้องสมุดของเอกสาร Word ที่อยู่ใน Confluence การแปลงเอกสารเหล่านั้นอย่างสะอาดนั้นค่อนข้างซับซ้อนกว่าที่ดูเหมือน การสนับสนุน Markdown ของ Confluence มีความแปลก คู่มือนี้จะแสดงให้คุณที่น่าเชื่อถือที่สุด Word ถึง Confluence กระบวนการทํางาน

Confluence สนับสนุน Markdown ไหม?

Confluence มีการสนับสนุน Markdown ส่วนหนึ่ง, แต่มันขึ้นอยู่กับการดําเนินการ:

• Confluence เมฆ สนับสนุนแมคโร Markdown และสามารถทําการแสดง Markdown ในสถานการณ์บางส่วน แต่เอดิเตอร์พื้นบ้านเป็นรูปแบบของตัวเอง
• Confluence ศูนย์ข้อมูล / เซอร์เวอร์ ยังมีแมคโร Markdown
• Atlassian Rovo / ผู้อํานวยการใหม่ เวอร์ชั่นใหม่ ๆ มีการปรับปรุงการสนับสนุน Paste Markdown

วิธีที่น่าเชื่อถือที่สุดในทุกเวอร์ชั่นคือการแปลง Word เป็น Markdown ด้วย WordToMD, จากนั้นติดเนื้อหา Markdown โดยใช้ลักษณะการนําเข้า Confluences Markdown

วิธีที่ 1: Paste Markdown ผ่าน Confluence Editor

ขั้นตอน

1. แปลงเอกสาร Word ของคุณที่ WordToMD และคลิก Copy Markdown
2. ใน Confluence เปิดการแก้ไขหน้า
3. จากเมนู Insert (+ ไอคอน) เลือก Markup หรือ Other Macros → Markup
4. เลือก Markdown เป็นภาษา
5. ตัดเนื้อหา Markdown
6. คลิก Insert

แมคโร Markup/Markdown ทําให้เนื้อหาเป็นบทความร่ํารวยภายในหน้า มันไม่แปลงเป็นบล็อก Confluence ที่เป็นพื้นฐาน แต่มันทํารายการหัวข้อ, ตารางและรายการให้ถูกต้อง

วิธีที่ 2: Word การนําเข้าไฟล์

Confluence Cloud มีลักษณะการนําเข้า Word:

1. สร้างหน้า Confluence ใหม่
2. คลิกเมนู ... → นําเข้าเอกสาร Word
3. เลือกไฟล์ .docx ของคุณ

วิธีนี้ทํางานสําหรับเอกสารง่าย ๆ แต่มักจะสูญเสียการจัดรูปแบบที่ซับซ้อน เส้นทาง Markdown ให้การควบคุมมากขึ้น

วิธีที่ 3: แปลงเป็น HTML

บางทีมชอบ HTML เป็นรูปแบบกลางเพราะ Confluences editor ยอมรับ HTML Paste:

1. เปลี่ยน Word doc เป็น Markdown ด้วย WordToMD
2. เปลี่ยน Markdown เป็น HTML โดยใช้เครื่องมือออนไลน์หรือ marked library
3. เปลี่ยนไปยัง Confluence Source Editor (Ctrl+Shift+D หรือจากตารางเครื่องมือ)
4. ติด HTML

แนวทางนี้อนุรักษ์การจัดรูปแบบที่ซับซ้อนกว่า แต่เป็นขั้นตอนมากกว่า

การประกอบรูปแบบ

โต๊ะรับมือ

Word ตารางแปลงเป็น GFM ไพป์การประโยคผ่าน WordToMD. Confluence’s Markdown macro renders these correctly:

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

สําหรับการปฏิบัติตารางที่ซับซ้อนกว่า ดู Markdown ตาราง: คู่มือที่ครบวงจร.

โค้ดบล็อกใน Confluence

Confluence มีแมคโรบล็อคโค้ดของตัวเอง ที่ให้การเร่งสัญญากลางและเลขแถว หลังจากนําเข้าเนื้อหา Markdown คุณอาจต้องการเปลี่ยนบล็อกโค้ดจากแมคโร Markdown ด้วยแมคโรบล็อกโค้ด Confluence ที่เป็นพื้นฐาน เพื่อให้อ่านได้ง่ายขึ้น:

1. แก้ไขหน้า
2. ค้นหาส่วนโค้ด
3. การใส่ แมคโรบล็อคโค้ด
4. กําหนดภาษาสําหรับการเร่งสัญญากลาง
5. ตัดรหัส

อ้างอิง: Markdown คอยด์บล็อค คู่มือ สําหรับสัญลักษณ์มาตรฐาน

แอทลาสเซียน Confluence และ ADF

Confluence Cloud ใช้เป็นพื้นฐาน แอตแลสเซียน Document Format (ADF) ระบบ JSON สําหรับเนื้อหาที่ร่ํารวย แมคโร Markdown อยู่บนนี้ สําหรับการนําเข้าแบบโปรแกรม, Confluence REST API รับ ADF โดยตรง. หากคุณกําลังสร้างท่ออัตโนมัติ, เปลี่ยน Word → Markdown → ADF โดยใช้ห้องสมุดที่มีอยู่.

สําหรับทีมส่วนใหญ่ การทํางานแบบมือถือจะง่ายและรวดเร็วขึ้น

การย้ายห้องสมุดเอกสาร

ถ้าหากคุณกําลังย้ายเอกสาร Word ไปยัง Confluence:

1. แปลงไฟล์ทั้งหมดโดยใช้ WordToMD (หรือแบรช) Pandoc สําหรับปริมาณใหญ่)
2. สร้างพื้นที่ Confluence และวางแผนระดับหน้า
3. การนําหน้าเข้าในส่วน การจัดกลุ่มเอกสารที่เกี่ยวข้องในหน้าหลัก
4. เพิ่มลักษณะเฉพาะ Confluence หลังการนําเข้า: แท็ก, ข้อจํากัดหน้า, @mentions

FAQ

ผมสามารถใช้ Markdown ได้ใน Confluence โดยไม่มีแมคโร? ในบางการตั้งค่าของ Confluence Cloud กับ New Editor คุณสามารถ type shortcuts Markdown และพวกเขา auto-convert (e.g., การตี ## สร้าง H2). แต่สําหรับการติดเอกสารที่เปลี่ยนไป, แมคโร Markdown นั้นน่าเชื่อถือกว่า.

การประกอบหัวข้อของฉันสูญเสียหลังจากการนําเข้า ทุกอย่างดูเหมือนบทความร่างกาย นี่มักหมายถึงแมคโร Markdown ไม่ได้ทํางาน Markdown ต้องอยู่ในบล็อกแมคโร Markup/Markdown, ไม่ติดเป็นข้อความเรียบในเครื่องแก้ไขมาตรฐาน.

ตารางแสดงเป็นตัวอักษรท่อสด ปัญหาเดียวกัน เนื้อหาต้องอยู่ในแม็คโคร Markdown ไม่ใช่ในเอดิเตอร์ข้อความมาตรฐาน

มีวิธีการอัตโนมัติในการสัมพันธ์เอกสาร Word กับหน้า Confluence ไหม? ใช่ เครื่องมือเช่น Confluences แผนการเอกสารภายนอก, Scroll Versions, หรือสกริปที่ทําตามลักษณะ โดยใช้ Confluence REST API สามารถสิงค์ไฟล์ Markdown ให้กับหน้าได้โดยอัตโนมัติ

การสรุป

สะอาดที่สุด Word ถึง Confluence การเคลื่อนไหวของงานคือ: เปลี่ยนแปลงด้วย WordToMD, จากนั้นนําเข้าผ่านแมคโร Markdown สําหรับเอกสารที่ซับซ้อนหรือการเคลื่อนไหวจํานวนมาก การเข้าถึงระหว่างทาง HTML หรือการอัตโนมัติ REST API ให้การควบคุมมากขึ้น ไม่ว่าจะเป็นอย่างไร การใช้รูปแบบหัวหน้าของ Word อย่างถูกต้องก่อนการแปลงจะทําให้การจัดเรียงชั้นของหน้าไม่เสียหาย