เครื่องมือนี้ทำอะไร
ตัวแปลง Markdown เป็น HTML เปลี่ยนข้อความ Markdown ให้เป็นมาร์กอัป HTML ที่นำไปวางใน CMS เทมเพลตอีเมล หน้าเว็บสแตติก หรือที่ใดก็ได้ที่รับ HTML แต่ไม่รองรับ Markdown เหมาะสำหรับเผยแพร่ README บนเว็บไซต์ ย้ายโน้ตไปยังตัวแก้ไขบล็อก หรือดูว่า Markdown ส่วนหนึ่งสร้างแท็กอะไรบ้าง
ผลลัพธ์เป็น HTML แบบเดียวกับที่ตัวเรนเดอร์ Markdown ยอดนิยมสร้าง ได้แก่ หัวข้อ <h1> ถึง <h6> ย่อหน้า <p> รายการ <ul> และ <ol> บล็อก <pre><code> ที่มี class language- สำหรับตัวไฮไลต์ไวยากรณ์ และมาร์กอัป <table> สำหรับตารางแบบ GitHub
วิธีใช้
- พิมพ์หรือวาง Markdown อัปโหลดไฟล์
.mdหรือคลิก ตัวอย่าง - เลือกตัวเลือกที่ต้องการ ได้แก่ GitHub Flavored Markdown ขึ้นบรรทัดใหม่เป็น
<br>ID ของหัวข้อสำหรับลิงก์แองเคอร์ การกรองให้ปลอดภัยสำหรับข้อมูลที่ไม่น่าเชื่อถือ และเอกสาร HTML แบบเต็มแทนการได้เพียงบางส่วน - คัดลอก HTML หรือดาวน์โหลดเป็นไฟล์
.html
ผลลัพธ์จะอัปเดตขณะพิมพ์ ปิดตัวเลือกเอกสารแบบเต็มเมื่อจะนำผลลัพธ์ไปวางในหน้าที่มีอยู่แล้ว และเปิดเมื่อต้องการไฟล์ที่ใช้งานได้ด้วยตัวเอง
ตัวอย่าง
Markdown นี้:
## Install
Run the **installer** and read the [guide](https://example.com).
- Windows
- macOS
จะกลายเป็น HTML นี้:
<h2>Install</h2>
<p>Run the <strong>installer</strong> and read the <a href="https://example.com">guide</a>.</p>
<ul>
<li>Windows</li>
<li>macOS</li>
</ul>
เคล็ดลับ
- ตามค่าเริ่มต้น HTML ดิบใน Markdown จะคงไว้ตามเดิม เช่นเดียวกับตัวเรนเดอร์ส่วนใหญ่ ควรเปิดการกรองให้ปลอดภัยทุกครั้งที่ Markdown เขียนโดยผู้อื่น
- เมื่อเปิด ID ของหัวข้อ คุณสามารถลิงก์ไปยังส่วนต่าง ๆ ด้วยที่อยู่อย่าง
page.html#installและสร้างสารบัญจากหัวข้อได้ - บล็อกโค้ดจะเก็บภาษาไว้เป็น class ตัวไฮไลต์อย่าง Prism หรือ highlight.js จึงจดจำได้โดยไม่ต้องตั้งค่าเพิ่ม
- หากต้องการดูผลลัพธ์ที่เรนเดอร์แล้วเคียงข้างกัน ใช้ตัวแสดงตัวอย่าง Markdown หากต้องการแปลงย้อนกลับ ใช้ตัวแปลง HTML เป็น Markdown
คำถามที่พบบ่อย
› รองรับไวยากรณ์ Markdown แบบใดบ้าง?
รองรับ CommonMark ทั้งหมด เช่น หัวข้อ การเน้นข้อความ ลิงก์ รูปภาพ รายการ คำอ้างอิง โค้ด และเส้นคั่นแนวนอน เมื่อเปิด GitHub Flavored Markdown จะได้ตารางที่จัดแนวคอลัมน์ได้ รายการงาน ขีดฆ่า และลิงก์อัตโนมัติสำหรับ URL เปล่า ๆ ด้วย
› ตัวเลือกกรองให้ปลอดภัยทำอะไร?
จะ escape HTML ดิบทั้งหมดใน Markdown ให้แสดงเป็นข้อความแทนที่จะกลายเป็นแท็ก และลบลิงก์กับรูปภาพที่ URL ใช้สคีมอันตรายอย่าง javascript หรือ vbscript ควรเปิดเมื่อ Markdown มาจากผู้ใช้ที่ไม่น่าไว้วางใจ เช่น ความคิดเห็นหรือโพสต์ในฟอรัม
› ID ของหัวข้อสร้างขึ้นอย่างไร?
ใช้วิธีเดียวกับ GitHub ข้อความหัวข้อจะถูกแปลงเป็นตัวพิมพ์เล็ก ลบเครื่องหมายวรรคตอน และเปลี่ยนช่องว่างเป็นยัติภังค์ ดังนั้น Getting Started จะได้ id เป็น getting-started หัวข้อที่ซ้ำกันจะได้ -1, -2 ต่อท้ายไปเรื่อย ๆ ทำให้ทุกแองเคอร์ไม่ซ้ำกัน
› ตัวเลือกเอกสาร HTML แบบเต็มมีไว้ทำอะไร?
จะห่อผลลัพธ์ด้วยหน้าเว็บที่สมบูรณ์ ซึ่งมี doctype, ชุดอักขระ UTF-8, แท็ก viewport, title ที่ได้จากหัวข้อระดับหนึ่งตัวแรก และสไตล์ชีตขนาดเล็กที่อ่านง่าย บันทึกเป็นไฟล์ .html แล้วเปิดในเบราว์เซอร์ใดก็ได้อย่างสวยงาม
› Markdown ของฉันถูกส่งไปที่ใดหรือไม่?
ไม่ การแปลงทำงานในเบราว์เซอร์ของคุณด้วยไลบรารี marked และไม่มีสิ่งใดถูกอัปโหลดไปยังเซิร์ฟเวอร์