เลือกข้อความบางส่วนเพื่อเผยแพร่ หรือเลือกไฟล์เพื่อแชร์
เว็บไซต์หรือระบบจัดการเนื้อหาอาจต้องใช้ HTML แม้คุณจะถนัดเขียน Markdown มากกว่า เปิดไฟล์ .md หรือวางเนื้อหา ตรวจผลลัพธ์ แล้วเลือกระหว่างส่วนเนื้อหากับเอกสาร HTML ฉบับสมบูรณ์
คัดลอก HTML จะได้ส่วนเนื้อหา ส่วนดาวน์โหลด HTML จะห่อเนื้อหาไว้ในเอกสารที่มีสไตล์และแบบอักษรคณิตศาสตร์ฝังอยู่ ผลลัพธ์สองแบบนี้ต่างกัน: ส่วนเนื้อหาต้องใช้ CSS จากปลายทาง ส่วนไฟล์ที่ดาวน์โหลดมีสไตล์เอกสารมาให้
เนื้อหาที่อยู่ใน HTML ซึ่งสร้างขึ้น
โครงสร้างอ่านง่าย
หัวข้อ รายการ ข้อความอ้างอิงแบบบล็อก ตาราง และลิงก์จะกลายเป็นองค์ประกอบ HTML สลับจากดูตัวอย่างไปที่ HTML เพื่อตรวจส่วนที่สร้างขึ้น
ผลลัพธ์ที่ใช้ได้สองรูปแบบ
คัดลอกส่วนเนื้อหาไปยัง CMS หรือดาวน์โหลดเอกสาร HTML ฉบับสมบูรณ์เพื่อตรวจสอบและแชร์ ไม่จำเป็นต้องลบกรอบหน้าเว็บทั้งหมดเมื่อปลายทางต้องการเฉพาะเนื้อหา
มีตัวอย่างทางเทคนิค
ไฮไลต์ภาษาของโค้ดยอดนิยมได้ สูตรและแผนภาพ Mermaid ที่รองรับจะแสดงผลก่อนส่งออก ระบบจะแจ้งข้อผิดพลาดในการส่งออกแทนการแทนที่เนื้อหาโดยไม่บอก
จัดสไตล์เอกสารแบบไฟล์เดี่ยว
ตั้งค่าตัวอักษรและสีก่อนดาวน์โหลด HTML แผนภาพที่แสดงผลจะฝังเป็น SVG และไฟล์ที่ดาวน์โหลดจะรวมแบบอักษรคณิตศาสตร์ไว้ด้วย
เริ่มจากเอกสารที่คุณต้องใช้จริง
ส่วนหนึ่งของเอกสารประกอบ
แปลงบทความส่วนสั้น ๆ ให้เข้ากับเค้าโครงเอกสารที่มีอยู่
## การติดตั้ง ติดตั้งแพ็กเกจและ **ตรวจผลลัพธ์** ```bash npm ci ``` > เก็บสำเนา Markdown ต้นฉบับไว้
- ระดับหัวข้อเหมาะกับหน้าเป้าหมาย
- คำสั่งอ่านง่าย
- ข้อความอ้างอิงมีบริบทที่ชัดเจน
ตารางเปรียบเทียบสำหรับบล็อก
เก็บข้อมูลตารางไว้เป็นเซลล์ HTML จริง แทนการใช้ภาพหน้าจอ
## รูปแบบการส่งมอบ | รูปแบบ | ขั้นตอนถัดไป | | --- | --- | | Markdown | แก้ไขต่อ | | HTML | เผยแพร่บนเว็บ | | PDF | แชร์เพื่ออ่าน |
- มีเซลล์หัวตาราง
- ข้อความพอดีกับหน้าจอแคบ
- ตรวจสอบลิงก์แล้ว
ขั้นตอนใช้งานจริง
วาง Markdown หรือเปิดไฟล์
ใช้ซอร์สของบทความหรือ README ของคุณ HTML ดิบที่อยู่นอกชุดแท็กจัดรูปแบบขนาดเล็กที่รองรับจะแสดงเป็นข้อความ
ตรวจสอบทั้งสองมุมมอง
ดูเอกสาร แล้วสลับไปที่ HTML เพื่อตรวจหัวข้อ ลิงก์ และโครงสร้างตาราง ตรวจสอบว่าปลายทางรองรับองค์ประกอบที่ต้องการ
เลือกส่วนเนื้อหาหรือทั้งเอกสาร
คัดลอก HTML ไปยังเครื่องมือเผยแพร่ที่รองรับมาร์กอัป ดาวน์โหลด HTML เมื่อต้องการไฟล์ที่จัดสไตล์แล้ว ทดสอบผลลัพธ์กับปลายทางจริงก่อนเผยแพร่
ตรวจสอบผลลัพธ์ก่อนแชร์
| เนื้อหา | สิ่งที่ควรทำ | สิ่งที่คาดหวัง |
|---|---|---|
| ส่วน HTML | ตรวจสอบมาร์กอัปและ CSS ที่ปลายทางอนุญาต | CMS อาจกรองสไตล์ SVG หรือเนื้อหาคณิตศาสตร์ แม้จะแสดงในตัวอย่างนี้ |
| HTML แบบไฟล์เดี่ยว | เปิดไฟล์ที่ดาวน์โหลดแยกต่างหาก | มีสไตล์เอกสารและแบบอักษรคณิตศาสตร์ ส่วนรูปภาพภายนอกที่เปิดใช้ยังขึ้นอยู่กับโฮสต์ของรูปภาพ |
| ลิงก์และสคริปต์ | ตรวจปลายทางของลิงก์ อย่าใช้การแปลงไฟล์เพื่อส่งสคริปต์ | เครื่องมือแปลงจะนำเนื้อหาเชิงรุกออก และแสดง HTML ดิบที่ไม่รองรับเป็นข้อความ |
คำถามเกี่ยวกับขั้นตอนนี้
แปลง Markdown เป็น HTML สำหรับเว็บไซต์ได้อย่างไร
เปิดไฟล์ .md หรือวางซอร์ส ตรวจตัวอย่าง แล้วเลือกคัดลอก HTML เพื่อรับมาร์กอัปของเนื้อหา เลือกดาวน์โหลด HTML เมื่อต้องการเอกสารที่มีสไตล์ครบ ก่อนเผยแพร่ให้ตรวจสอบว่าเว็บไซต์จัดการ HTML ที่วางไว้อย่างไร
คัดลอก HTML กับดาวน์โหลด HTML ต่างกันอย่างไร
คัดลอก HTML ให้ส่วนเนื้อหา ส่วนดาวน์โหลด HTML ให้เอกสารครบถ้วนที่มีชื่อเรื่อง สไตล์เอกสาร และเนื้อหาที่แสดงผลแล้ว
แปลงตาราง Markdown เป็นตาราง HTML ได้ไหม
ได้ ตารางแบบไปป์จะกลายเป็นองค์ประกอบตาราง HTML ไวยากรณ์ตาราง Markdown พื้นฐานไม่รองรับเซลล์ผสานที่ซับซ้อน จึงอาจต้องแก้ไขด้วยตนเอง
HTML มีสูตรและ Mermaid ด้วยหรือไม่
สูตรที่รองรับจะแสดงด้วย KaTeX และแผนภาพ Mermaid จะฝังเป็น SVG เอกสารที่ดาวน์โหลดมีแบบอักษรคณิตศาสตร์ ส่วนส่วนเนื้อหาที่คัดลอกอาจต้องใช้สไตล์จากปลายทาง
นำผลลัพธ์ไปวางใน CMS ใดก็ได้หรือไม่
ตรวจข้อกำหนดของ CMS ก่อน ตัวแก้ไขบางตัวรับซอร์ส HTML ส่วนบางตัวแสดงแท็กที่วางเป็นข้อความหรือลบ SVG และเนื้อหาคณิตศาสตร์ ลองทดสอบตัวอย่างขนาดเล็กในขั้นตอนเผยแพร่จริง
HTML ที่ดาวน์โหลดใช้งานออฟไลน์ได้ทั้งหมดหรือไม่
มีสไตล์เอกสาร แผนภาพที่แสดงผล และแบบอักษรคณิตศาสตร์มาให้ ส่วนรูปภาพและลิงก์ภายนอกยังชี้ไปยังตำแหน่งเดิม เว้นแต่จะฝังรูปภาพไว้
มีการอัปโหลด Markdown เพื่อแปลงไฟล์หรือไม่
การแปลง Markdown เป็น HTML และดาวน์โหลด HTML ทำในเบราว์เซอร์ มีเพียงการดาวน์โหลด PDF แยกต่างหากที่ส่งเอกสารที่แสดงผลมายังเว็บไซต์นี้
เครื่องมือนี้จัดการเอกสารของคุณอย่างไร
- การแยกวิเคราะห์ Markdown และสร้าง HTML ทำในเครื่อง
- HTML ที่คัดลอกเป็นส่วนเนื้อหา ส่วน HTML ที่ดาวน์โหลดเป็นเอกสารพร้อมสไตล์
- นำเนื้อหาเชิงรุกออกแล้ว แต่ควรตรวจลิงก์และข้อกำหนดของ CMS ด้วย
ข้อมูลอ้างอิงรูปแบบอ้างอิงองค์ประกอบ HTMLข้อกำหนด CommonMark
แจ้งปัญหาที่ทำซ้ำได้ระบุเบราว์เซอร์ การตั้งค่าที่เลือก และตัวอย่างขนาดเล็กที่ไม่มีข้อมูลลับ อย่าส่งเอกสารส่วนตัวทางอีเมล
