แปลงฟรี

มาร์กดาวน์ไปที่ ตัวแปลง HTML

แปลงข้อความ Markdown ให้เป็นโค้ด HTML ที่พร้อมใช้งานจริงพร้อมรองรับการแสดงตัวอย่างแบบเรียลไทม์

เกี่ยวกับเครื่องมือนี้

Markdown เป็นภาษามาร์กอัปแบบน้ำหนักเบาที่สร้างขึ้นโดย John Gruber ในปี 2004 เพื่อให้ผู้เขียนสร้าง HTML ที่มีโครงสร้างโดยใช้รูปแบบข้อความธรรมดา: อักขระแฮชสำหรับส่วนหัว เครื่องหมายดอกจันสำหรับการเน้น ยัติภังค์สำหรับรายการ บล็อกเยื้องสำหรับโค้ด รูปแบบนี้กลายเป็นค่าเริ่มต้นสำหรับไฟล์ README เอกสารทางเทคนิค ร่างบล็อก เครื่องมือสร้างไซต์แบบคงที่ และบริบทใดๆ ที่การเขียนควรอ่านได้ในรูปแบบข้อความธรรมดาและเป็นเอาต์พุตที่แสดงผล การแปลง Markdown เป็น HTML เป็นขั้นตอนการเรนเดอร์ที่เปลี่ยนแหล่งที่มาให้เป็นหน้าเว็บ

ตัวแปลงนี้ใช้ไลบรารีที่ทำเครื่องหมายไว้ ซึ่งเป็นตัวเรนเดอร์ Markdown ที่นำมาใช้กันอย่างแพร่หลายที่สุดใน JavaScript Marked รองรับ CommonMark และ GitHub Flavoured Markdown (GFM) ซึ่งหมายความว่าตาราง บล็อกโค้ดที่ไม่รั้ว รายการงาน ขีดฆ่า และการเชื่อมโยงอัตโนมัติทั้งหมดทำงานได้อย่างถูกต้อง นอกเหนือจากฟีเจอร์ Markdown มาตรฐาน

เอาต์พุตเป็น HTML ธรรมดา — แท็กเชิงความหมายสำหรับส่วนหัว ย่อหน้า รายการ ลิงก์ และรูปภาพ รวมถึงคลาส hooks สำหรับบล็อกโค้ดที่เครื่องมือเน้นไวยากรณ์คาดหวังไว้ วางเอาต์พุตลงใน CMS ใดๆ ได้อย่างหมดจด ฝังไว้ในเครื่องมือสร้างไซต์แบบคงที่ หรือทำหน้าที่เป็น .html แบบสแตนด์อโลน ไม่มีการเพิ่ม CSS หรือ JavaScript; การจัดรูปแบบผลลัพธ์จะเป็นไปตามบริบทดาวน์สตรีมของคุณ

เหตุใดจึงต้องแปลง Markdown เป็น HTML

Markdown เป็นรูปแบบที่ผู้เขียนและนักพัฒนาต้องการ HTML คือรูปแบบที่เบราว์เซอร์แสดงผล ตัวสร้างไซต์คงที่และแพลตฟอร์ม CMS ส่วนใหญ่แปลง Markdown เป็น HTML เบื้องหลัง แต่บางครั้งคุณจำเป็นต้องมีการแปลงเป็นขั้นตอนเดี่ยวๆ — วางลงใน CMS ที่ไม่รองรับ Markdown, สร้าง HTML สำหรับอีเมล, สร้างการแสดงตัวอย่างอย่างรวดเร็ว หรือแยกเอาต์พุตที่แสดงผลเพื่อการประมวลผลเพิ่มเติม

HTML ยังเป็นรูปแบบมาตรฐานสำหรับเนื้อหาใดๆ ที่จะแสดงในเบราว์เซอร์ในที่สุด จดหมายข่าวทางอีเมลที่สร้างขึ้นจากร่าง Markdown หน้าเอกสารที่ฝังอยู่ในแอปพลิเคชัน HTML ขนาดใหญ่ และโพสต์ในบล็อกที่วางลงในบรรณาธิการที่คาดหวังว่า HTML ล้วนได้รับประโยชน์จากการแปลงแบบใหม่

วิธีใช้งาน

วาง Markdown รับ HTML

  1. เพิ่มมาร์กดาวน์ของคุณ: วางข้อความ Markdown ลงในพื้นที่ป้อนข้อมูลหรือวางไฟล์ .md ทั้งไวยากรณ์ Markdown มาตรฐานและ GitHub Flavoured Markdown ทำงานได้
  2. แปลง: ทำเครื่องหมายแยกวิเคราะห์ Markdown เป็น AST และปล่อย HTML องค์ประกอบอินไลน์มาตรฐาน (เน้น เน้น ลิงก์ โค้ด รูปภาพ) องค์ประกอบบล็อก (ส่วนหัว ย่อหน้า รายการ เครื่องหมายคำพูด) และส่วนขยาย GFM (ตาราง โค้ดที่ไม่รั้ว รายการงาน ลิงก์อัตโนมัติ) ทั้งหมดแสดงผลได้อย่างถูกต้อง
  3. ดูตัวอย่าง: ตรวจสอบ HTML ที่แสดงผลในแผงแสดงตัวอย่าง ยืนยันว่าบล็อกโค้ด ตาราง และองค์ประกอบที่ซับซ้อนอื่นๆ ปรากฏขึ้นตามที่คาดไว้
  4. คัดลอกหรือดาวน์โหลด: คัดลอก HTML ไปยังคลิปบอร์ดเพื่อวางลงใน CMS หรือบันทึกเป็น .html สำหรับการใช้งานแบบสแตนด์อโลน ผลลัพธ์เป็น HTML5 เชิงความหมายโดยไม่มีสไตล์อินไลน์

กรณีการใช้งานทั่วไป

รายละเอียดทางเทคนิค

Marked ใช้สถาปัตยกรรมแบบสองผ่าน โทเค็น lexer อินพุตเป็นโทเค็นระดับบล็อก (ส่วนหัว ย่อหน้า รายการ บล็อกโค้ด) และโทเค็นอินไลน์ (เน้น ลิงก์ รูปภาพ) parser เดินสตรีมโทเค็นและส่ง HTML โดยใช้ hooks ของตัวแสดงผลสำหรับโทเค็นแต่ละประเภท

ส่วนขยาย GitHub Flavoured Markdown ถูกเปิดใช้งานตามค่าเริ่มต้น: ตาราง (ใช้ไวยากรณ์ไปป์), บล็อกโค้ดรั้ว (แบ็คทิกสามตัวพร้อมคำแนะนำภาษา), รายการงาน (- [ ] และ - [x]), ขีดทับ (ใช้เครื่องหมายตัวหนอนคู่) และการเชื่อมโยง URL อัตโนมัติ บล็อกโค้ดปล่อยโค้ดที่ล้อมรอบไว้ล่วงหน้าพร้อมคลาสภาษาเสริมสำหรับการเน้นไวยากรณ์ดาวน์สตรีม

การฆ่าเชื้อผลผลิตตกเป็นของผู้บริโภคขั้นปลาย Marked จะปล่อยทุกอย่างที่อินพุตสร้างขึ้น รวมถึง HTML แบบดิบที่ฝังอยู่ใน Markdown หากคุณยอมรับอินพุตที่ไม่น่าเชื่อถือ ให้เรียกใช้เอาต์พุตผ่าน DOMPurify หรือโปรแกรมล้าง HTML ที่คล้ายกันก่อนที่จะเรนเดอร์ในเบราว์เซอร์

แนวทางปฏิบัติที่ดีที่สุด

คำถามที่พบบ่อย

การแปลง MARKDOWN เป็น HTML เปลี่ยนแปลงเนื้อหาหรือไม่
เนื้อหาจะถูกเก็บรักษาไว้อย่างถูกต้องที่สุด อย่างไรก็ตาม คุณลักษณะเฉพาะบางรูปแบบอาจไม่เทียบเท่าโดยตรง ดังนั้นการจัดรูปแบบเล็กน้อยจึงอาจเกิดขึ้นได้
รูปแบบ HTML ใช้ทำอะไร?
HTML (HyperText Markup Language) ใช้สำหรับหน้าเว็บและเนื้อหาเว็บเป็นหลัก
มีข้อจำกัดที่ต้องทราบหรือไม่?
รองรับไฟล์ขนาดสูงสุด 50MB ไฟล์ที่มีขนาดใหญ่มากหรือซับซ้อนอาจใช้เวลาในการประมวลผลนานกว่า การแปลงทั้งหมดเกิดขึ้นในเบราว์เซอร์ของคุณ ดังนั้นความเร็วในการประมวลผลจึงขึ้นอยู่กับอุปกรณ์ของคุณ
การแปลงนี้ปลอดภัยและเป็นส่วนตัวหรือไม่?
ใช่. การประมวลผลทั้งหมดเกิดขึ้นภายในเบราว์เซอร์ของคุณ ข้อมูลของคุณจะไม่ออกจากอุปกรณ์ของคุณ ไม่มีการอัปโหลดเซิร์ฟเวอร์ ไม่มีการประมวลผลบนคลาวด์ ไม่มีการรวบรวมข้อมูล
รองรับอิโมจิหรือไม่?
อิโมจิ Unicode ส่งผ่านโดยตรง (การพิมพ์อิโมจิหัวใจจะแสดงหัวใจในเอาต์พุต) สไตล์ GitHub :emoji: รหัสย่อจะไม่ถูกแปลงตามค่าเริ่มต้น เพิ่มส่วนขยายหากคุณต้องการ
Markdown ของฉันถูกอัพโหลดไปยังเซิร์ฟเวอร์หรือไม่?
ไม่ ทำเครื่องหมายว่าทำงานในเบราว์เซอร์ของคุณ การแปลงเกิดขึ้นบนอุปกรณ์ของคุณทั้งหมด
ฉันสามารถเพิ่มสไตล์ที่กำหนดเองให้กับ HTML ได้หรือไม่
ใช่ หลังจากการแปลง ผลลัพธ์เป็น HTML ความหมายธรรมดา ใช้ CSS ของคุณเองเพื่อจัดรูปแบบส่วนหัว บล็อกโค้ด ตาราง และองค์ประกอบอื่นๆ
รองรับเชิงอรรถหรือไม่?
Standard CommonMark ไม่ได้ระบุไวยากรณ์เชิงอรรถ ส่วนขยาย Markdown บางส่วนรองรับไวยากรณ์เชิงอรรถ [^1] ตัวแปลงนี้เป็นไปตาม GFM ซึ่งไม่มีเชิงอรรถ