ตัวแปลง

แปลง Markdown เป็น HTML

แปลง Markdown เป็น HTML คือตัวแปลงในเบราว์เซอร์ที่เปลี่ยน CommonMark และ GitHub Flavored Markdown เป็น HTML ที่ผ่านการทำความสะอาด — รวมหัวข้อ ตาราง รายการงาน และโค้ดแบบ fenced ไม่มีการอัปโหลดใด ๆ; ตัวเรนเดอร์เดียวกันทำงานอยู่เบื้องหลัง POST /v1/convert/markdown/html

# markitdown-ai

Convert documents to clean Markdown.

## Features

- PDF, Word, and slides
- [x] Tables stay tables
- [ ] Mermaid coming later

## Install

```bash
pnpm add @markitdown-ai/sdk
```

## API

| Method | Path |
| --- | --- |
| POST | /v1/convert/{name} |
| GET | /v1/conversions/{id} |

วิธีใช้

วิธีแปลง Markdown เป็น HTML

สิ่งที่คุณวางได้

Markdown ใดก็ได้: CommonMark บวกตาราง รายการงาน และขีดฆ่าของ GitHub Flavored Markdown
การเรนเดอร์ทำงานในเบราว์เซอร์ของคุณ — ไม่มีการอัปโหลดขณะคุณพิมพ์
ไม่ต้องมีบัญชีในการดูตัวอย่าง คัดลอก หรือดาวน์โหลด
ไม่มีขีดจำกัดขนาดตายตัว; เอกสารที่ใหญ่มากถูกจำกัดด้วยหน่วยความจำของเบราว์เซอร์

แปลง Markdown เป็น HTML: หน้าต่างแก้ไข Markdown ทางซ้ายกลายเป็นหน้า HTML ทางขวา

ทำไมต้องใช้

ทำไมต้องใช้ตัวแปลง Markdown เป็น HTML นี้

ฟิลด์ CMS ไซต์สถิต และตัวแก้ไขอีเมล ต้องการมาร์กอัป ไม่ใช่ซอร์ส Markdown ตัวแปลงนี้เก็บส่วนที่สื่อความหมายและตัดสิ่งที่ทำให้ HTML ดิบไม่ปลอดภัยออก

ทำงานในเบราว์เซอร์ของคุณ

วาง Markdown แล้วตัวอย่าง HTML อัปเดตในเครื่อง ไม่มีการอัปโหลด และไม่ต้องมีบัญชีในการดูตัวอย่าง คัดลอก หรือดาวน์โหลด

CommonMark บวก GFM

หัวข้อ รายการ ลิงก์ บล็อกอ้าง และโค้ดแบบ fenced เป็นไปตาม CommonMark; ตาราง รายการงาน และขีดฆ่าเป็นไปตาม GitHub Flavored Markdown

ทำความสะอาดโดยค่าเริ่มต้น

แท็กสคริปต์ ตัวจัดการเหตุการณ์ในบรรทัด และ scheme ของ href หรือ src ที่ไม่ปลอดภัยจะถูกตัดออก HTML จึงปลอดภัยพอจะวางลงหน้าเว็บที่คุณไม่ได้ควบคุมทั้งหมด

ชิ้นส่วนหรือเอกสารเต็ม

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

สมอของหัวข้อ

ทุกหัวข้อได้ id ที่เสถียรและปลอดภัยสำหรับ URL สร้างแบบเดียวกับที่ API ทำ สารบัญหรือลิงก์ตรงจึงยังใช้ได้หลังคุณเผยแพร่

เอนจินเดียวกับ API

ตัวอย่างนี้กับ POST /v1/convert/markdown/html ใช้ตัวเรนเดอร์เดียวกัน HTML ที่คุณคัดลอกที่นี่จึงตรงกับการเรียกอัตโนมัติทุกไบต์

ปัญหา

ทำไม Markdown ดิบจึงใส่ลงหน้าเว็บโดยตรงไม่ได้

ไวยากรณ์ Markdown ไม่ใช่ HTML

ฟิลด์ CMS เทมเพลตอีเมล หรือธีมไซต์สถิตต้องการมาร์กอัป ไม่ใช่ซอร์ส Markdown ข้อความดิบจึงต้องถูกแปลงก่อนจึงจะจัดสไตล์หรือฝังได้

ตัวแยกวิเคราะห์ธรรมดาพลาด GFM

ตาราง รายการงาน และขีดฆ่าเป็นส่วนขยายของ GitHub Flavored Markdown; ตัวแยกวิเคราะห์ที่มีแต่ CommonMark จะเรนเดอร์เป็นอักขระไปป์และตัวหนอนตามตัวอักษรแทนโครงสร้าง

Markdown ที่ไม่น่าเชื่อถืออาจพาสคริปต์มา

Markdown ฝัง HTML ดิบได้ รวมถึงแท็ก <script> และตัวจัดการเหตุการณ์ในบรรทัด ซึ่งต้องถูกตัดออกก่อนผลลัพธ์จะปลอดภัยพอจะใส่ลงหน้าเว็บที่คุณไม่ได้ควบคุมทั้งหมด

แปลงไฟล์ Markdown เป็น HTML: ข้อความที่คัดลอกมาแล้วผิดเพี้ยนเทียบกับโครงสร้าง Markdown ที่เรียบร้อย

สิ่งที่เก็บไว้

ตัวแปลง Markdown เป็น HTML นี้เก็บอะไรไว้

หัวข้อและข้อความในบรรทัด: หัวข้อแบบ ATX และ setext ตัวเน้น ลิงก์ และบล็อกอ้างเป็นไปตาม CommonMark; ทุกหัวข้อยังได้ id ที่ปลอดภัยสำหรับ URL ซึ่งสร้างจากข้อความของมันSource: CommonMark Spec
ตาราง รายการงาน และขีดฆ่า: ตารางของ GitHub Flavored Markdown กลายเป็น element <table>, รายการ [ ] และ [x] กลายเป็นอินพุตเช็กบ็อกซ์ และ ~~text~~ กลายเป็น <del>Source: GitHub Flavored Markdown Spec
มาร์กอัปที่ทำความสะอาดแล้ว: แท็ก <script> ดิบ ตัวจัดการเหตุการณ์ในบรรทัด และค่า href หรือ src ที่อยู่นอกเหนือ http, https และ mailto จะถูกตัดออกก่อนคืนค่า HTMLSource: HTML Living Standard
โค้ดแบบ fenced: บล็อกโค้ดแบบ fenced เก็บเนื้อหาและป้ายภาษาของมัน; ตัวอย่างในเบราว์เซอร์ไม่ใช้ธีมไฮไลต์ไวยากรณ์ใด ๆSource: CommonMark Spec
HTML ดิบในซอร์ส: Markdown ที่ฝังแท็ก HTML ดิบอื่นจะผ่านตัวทำความสะอาดเดียวกัน แท็กที่ฝังมาจึงไม่ถูกถือเป็นมาร์กอัปที่เชื่อถือได้Source: HTML Living Standard

ตัวอย่าง Markdown เป็น HTML ที่ตรวจสอบแล้ว· https://markitdown.ai/blog/why-pdfs-break-llms

<h2 id="what-actually-goes-wrong">What actually goes wrong</h2><p>When teams pipe documents straight into an LLM or a retrieval index, a few failure modes show up again and again:</p><ul><li><strong>Reading order breaks.</strong> Multi-column layouts interleave. A two-column page becomes "line 1 left, line 1 right, line 2 left, line 2 right…", so a sentence a human reads top-to-bottom arrives at the model scrambled.</li><li><strong>Tables collapse.</strong> Copy-paste turns a table into a loose run of numbers. The relationship between a header and its cell — the entire point of a table — is gone.</li><li><strong>Headings disappear.</strong> The visual hierarchy (this is a section, this is a subsection) is encoded as font size and weight, not structure. Strip the styling and you get one undifferentiated wall of text.</li><li><strong>Noise creeps in.</strong> Page numbers, running headers, hyphenated line breaks, and stray ligatures end up inline, polluting prompts and embeddings alike.</li></ul><p>Read more in the <a href="https://markitdown.ai/blog/why-pdfs-break-llms">full article</a>.</p>

กรณีใช้งาน

กรณีใช้งานของการแปลง Markdown เป็น HTML

ที่ใดที่ปลายทางต้องการมาร์กอัปขณะต้นทางยังเป็น Markdown ตัวแปลงนี้คือขั้นกลางนั้น

เอกสารและไซต์สถิต

เปลี่ยน README หรือบทความฐานความรู้ Markdown เป็น HTML ที่ตัวสร้างไซต์สถิตหรือฟิลด์ CMS ต้องการ

อีเมลและจดหมายข่าว

ร่างข้อความใน Markdown แปลงเป็น HTML แล้ววางชิ้นส่วนลงตัวแก้ไขอีเมลที่คุณส่งจริง

ทำความสะอาดคำตอบ LLM

ChatGPT, Claude และ Gemini คืนค่า Markdown; แปลงเป็น HTML เมื่อปลายทางอย่างตั๋วงานหรือหน้าวิกิเรนเดอร์มาร์กอัปแทนเครื่องหมายดอกจันดิบ

นักพัฒนาที่ทำการเรนเดอร์อัตโนมัติ

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

Markdown เป็น HTML: หน้า HTML ที่เรนเดอร์แล้วนำไปใช้บนเว็บไซต์ อีเมล และเอกสาร

API

Markdown เป็น HTML API สำหรับนักพัฒนา

การเรนเดอร์ทำงานแบบซิงโครนัสและใช้ 0 เครดิต — แต่ยังนับในขีดจำกัดอัตราต่อนาทีของแพ็กเกจคุณ ส่ง Markdown เป็นข้อความ หรืออ้างอิงไฟล์ .md ที่จัดเก็บไว้ ไปที่ POST /v1/convert/markdown/html พร้อม API key ของคุณ; HTML ที่ทำความสะอาดแล้วจะกลับมาในคำตอบ

อ่านคู่มือ API

curl -X POST https://api.markitdown.ai/v1/convert/markdown/html \  -H "x-api-key: mdai_…" \  -H "Content-Type: application/json" \  -d '{ "text": "# Notes\n\nHello **world**." }'

คู่มือ

เอกสารและไซต์สถิต

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

เก็บไฟล์ Markdown เป็นแหล่งความจริงของคุณ; มอง HTML เป็นผลงานจากขั้น build
เทียบผลลัพธ์ที่เรนเดอร์กับธีมจริงของไซต์คุณ ไม่ใช่แค่สไตล์ตัวอย่างในหน้านี้
รันการแปลงใหม่ทุกครั้งหลังแก้ซอร์ส แทนการแพตช์ HTML ที่สร้างแล้วด้วยมือ

การทำความสะอาด

Markdown ฝัง HTML ดิบได้ และ HTML ดิบนั้นอาจมีแท็ก <script> หรือตัวจัดการเหตุการณ์ในบรรทัดอย่าง onclick ก่อนตัวแปลงนี้คืนผลลัพธ์ มาร์กอัปนั้นจะผ่านตัวทำความสะอาดที่เอา element ของสคริปต์ออก ตัดแอตทริบิวต์ใดก็ตามที่ขึ้นต้นด้วย "on" และอนุญาตเฉพาะลิงก์และแหล่งรูปภาพแบบ http, https และ mailto สิ่งที่รอดคือโครงสร้างเชิงความหมาย — หัวข้อ ย่อหน้า รายการ ตาราง ลิงก์ รูปภาพ และโค้ด — ไม่ใช่สไตล์ตกแต่ง ตัวแปลงไม่ฉีด class หรือไฟล์ CSS ลงในผลลัพธ์แบบชิ้นส่วน; การดาวน์โหลดเอกสารเต็มจะเพิ่มธีมที่คุณเห็นในตัวอย่างเพื่อให้ไฟล์เปิดได้ถูกต้องด้วยตัวเอง

ชิ้นส่วนหรือหน้าเต็ม

ชิ้นส่วนคือมาร์กอัปภายใน — หัวข้อ ย่อหน้า และตาราง — โดยไม่มี <html> หรือ <head> ครอบ มันเหมาะอยู่ภายในหน้าที่นิยามโครงสร้างเอกสารและสไตล์ของตัวเองแล้ว เช่น ฟิลด์เนื้อหา CMS หรือคอมโพเนนต์ที่เรนเดอร์บุตร เอกสารเต็มจะเพิ่ม doctype ชื่อเรื่อง และสไตล์ชีตเล็ก ๆ เพื่อให้ไฟล์เปิดตรงในเบราว์เซอร์หรือบันทึกเดี่ยวได้ การวางเอกสารเต็มลงในฟิลด์ที่คาดหวังชิ้นส่วนเป็นความผิดพลาดที่พบบ่อย: เบราว์เซอร์อาจยังเรนเดอร์มัน แต่แท็ก <html> และ <head> ที่ซ้อนอยู่ไม่ถูกต้องตรงนั้น และอาจทำให้เครื่องมือปลายทางที่คาดหวังชิ้นส่วนสับสน

ตัวแปลง Markdown อื่น ๆ

Need it in your code? Use the developer API. Converting at scale? See plans and pricing.

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

คำถามที่พบบ่อยเกี่ยวกับ Markdown เป็น HTML

Markdown เป็น HTML ทำงานอย่างไร?

วางหรือพิมพ์ Markdown แล้วตัวแปลงจะเรนเดอร์ HTML ที่ทำความสะอาดแล้วในเบราว์เซอร์ของคุณ โดยใช้ตัวเรนเดอร์เดียวกับ POST /v1/convert/markdown/html ไม่มีการอัปโหลดใด ๆ ขณะคุณพิมพ์

Markdown เป็น HTML รองรับ GitHub Flavored Markdown ไหม?

รองรับ ตาราง รายการงาน และขีดฆ่าเป็นไปตามสเปก GitHub Flavored Markdown ควบคู่กับหัวข้อ รายการ ลิงก์ และโค้ดของ CommonMark

ผลลัพธ์ HTML ผ่านการทำความสะอาดไหม?

ผ่าน แท็กสคริปต์ ตัวจัดการเหตุการณ์ในบรรทัด และ scheme ของ href หรือ src ที่ไม่ปลอดภัยถูกตัดออก HTML จึงปลอดภัยพอจะวางลงหน้าเว็บที่คุณไม่ได้ควบคุมทั้งหมด

ขอเอกสาร HTML เต็มแทนชิ้นส่วนได้ไหม?

ได้ เลือกเอกสารครบชุดพร้อมสไตล์ที่เห็นในตัวอย่าง หรือคัดลอกแค่ชิ้นส่วนสำหรับหน้าที่มีเลย์เอาต์ของตัวเอง

ต้องมีบัญชีในการแปลง Markdown เป็น HTML ไหม?

ไม่ต้อง การดูตัวอย่าง คัดลอก และดาวน์โหลดใช้งานได้โดยไม่ต้องเข้าสู่ระบบ เพราะการเรนเดอร์ทำงานในเบราว์เซอร์ของคุณ

ตอนพิมพ์เรียก API หรือไม่?

ไม่ การพิมพ์อยู่ในเครื่องเท่านั้น API ทำงานเฉพาะเมื่อคุณเรียก POST /v1/convert/markdown/html โดยตรง เช่นจากสคริปต์

Markdown ที่ฉันแปลงมีขีดจำกัดขนาดไหม?

ไม่มีขีดจำกัดการอัปโหลดตายตัวเพราะไม่มีการอัปโหลด; ขีดจำกัดในทางปฏิบัติขึ้นอยู่กับหน่วยความจำของเบราว์เซอร์สำหรับเอกสารขนาดใหญ่มาก