markitdown.ai
Mulai

Konverter

Konverter Markdown ke HTML

Markdown ke HTML adalah konverter browser yang mengubah CommonMark dan GitHub Flavored Markdown menjadi HTML yang disanitasi: mencakup judul, tabel, daftar tugas, dan kode berpagar. Tidak ada yang diunggah; renderer yang sama berjalan di balik 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} |

Cara kerja

Cara mengonversi Markdown ke HTML

Apa yang bisa Anda tempel

  • Markdown apa pun: CommonMark plus tabel, daftar tugas, dan coretan GitHub Flavored Markdown
  • Rendering berjalan di browser Anda — tidak ada yang diunggah saat Anda mengetik
  • Tidak perlu akun untuk mempratinjau, menyalin, atau mengunduh
  • Tanpa batas ukuran tetap; dokumen yang sangat besar dibatasi memori browser Anda
Markdown ke HTML: editor Markdown di kiri berubah menjadi halaman HTML terender di kanan

Mengapa memakainya

Mengapa memakai konverter Markdown ke HTML ini

Bidang CMS, situs statis, dan editor email menginginkan markup, bukan kode Markdown. Konverter ini mempertahankan bagian yang memberi makna dan membuang bagian yang membuat HTML mentah tidak aman.

Berjalan di browser Anda

Tempel Markdown dan pratinjau HTML diperbarui secara lokal. Tidak ada yang diunggah dan tidak perlu akun untuk mempratinjau, menyalin, atau mengunduh.

CommonMark plus GFM

Judul, daftar, tautan, kutipan, dan kode berpagar mengikuti CommonMark; tabel, daftar tugas, dan coretan mengikuti GitHub Flavored Markdown.

Disanitasi secara default

Tag script, penangan peristiwa inline, dan skema href atau src yang tidak aman dihapus, sehingga HTML-nya aman ditempel ke halaman yang tidak sepenuhnya Anda kendalikan.

Potongan atau dokumen lengkap

Salin hanya markup yang dirender untuk halaman yang sudah punya tata letaknya sendiri, atau unduh dokumen HTML lengkap dengan gaya dari pratinjaunya.

Jangkar judul

Setiap judul mendapat id stabil yang ramah URL, dihasilkan sama seperti di API, sehingga daftar isi atau tautan langsung tetap berfungsi setelah diterbitkan.

Mesin yang sama dengan API

Pratinjau ini dan POST /v1/convert/markdown/html memakai renderer yang sama, sehingga HTML yang Anda salin di sini sama persis dengan panggilan otomatis.

Masalahnya

Mengapa Markdown mentah tidak bisa langsung ke halaman web

Sintaks Markdown bukan HTML

Bidang CMS, templat email, atau tema situs statis menginginkan markup, bukan kode Markdown, sehingga teks mentahnya harus dikonversi dulu sebelum bisa diberi gaya atau disematkan.

Parser sederhana tidak mencakup GFM

Tabel, daftar tugas, dan coretan adalah ekstensi GitHub Flavored Markdown; parser yang hanya paham CommonMark merendernya sebagai garis dan gelombang literal, bukan sebagai struktur.

Markdown yang tidak tepercaya bisa membawa skrip

Markdown bisa menyematkan HTML mentah, termasuk tag <script> dan penangan peristiwa inline, yang harus dihapus sebelum keluarannya aman disisipkan ke halaman yang tidak sepenuhnya Anda kendalikan.

Konversi Markdown ke HTML: teks salin-tempel berantakan di samping struktur Markdown yang rapi

Apa yang dipertahankan

Apa yang dipertahankan konverter Markdown ke HTML ini

Judul dan teks inline
Judul ATX dan setext, penekanan, tautan, dan kutipan mengikuti CommonMark; setiap judul juga mendapat id ramah URL yang dihasilkan dari teksnya.Source: CommonMark Spec
Tabel, daftar tugas, dan coretan
Tabel GitHub Flavored Markdown diubah menjadi elemen <table>, item [ ] dan [x] menjadi kotak centang, dan ~~teks~~ menjadi <del>.Source: GitHub Flavored Markdown Spec
Markup yang disanitasi
Tag <script> mentah, penangan peristiwa inline, dan nilai href atau src di luar http, https, dan mailto dihapus sebelum HTML dikembalikan.Source: HTML Living Standard
Kode berpagar
Blok kode berpagar mempertahankan isi dan label bahasanya; pratinjau browser itu sendiri tidak menerapkan tema penyorotan sintaksis apa pun.Source: CommonMark Spec
HTML mentah di sumber
Markdown yang menyematkan tag HTML mentah lain melewati sanitizer yang sama, sehingga tag yang disematkan tidak pernah diperlakukan sebagai markup tepercaya.Source: HTML Living Standard

Kutipan Markdown ke HTML terverifikasi· 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>

Kasus penggunaan

Kasus penggunaan konversi Markdown ke HTML

Ketika tujuan menginginkan markup sementara sumbernya tetap Markdown, konverter ini adalah langkah perantaranya.

Dokumentasi dan situs statis

Konversi README atau artikel Markdown dari basis pengetahuan menjadi HTML yang diharapkan generator situs statis atau bidang CMS.

Draf email dan buletin

Tulis pesan dalam Markdown, konversi ke HTML, lalu tempel potongannya ke editor email yang benar-benar Anda pakai untuk mengirim.

Membersihkan respons LLM

ChatGPT, Claude, dan Gemini mengembalikan Markdown; konversi ke HTML saat tujuannya, entah tiket atau halaman wiki, merender markup alih-alih tanda bintang mentah.

Pengembang yang mengotomatiskan rendering

Panggil endpoint rendering dari proses yang menyimpan Markdown tetapi menyajikan HTML, tanpa menambahkan pustaka Markdown ke setiap layanan.

Markdown ke HTML online: halaman HTML terender dipakai untuk situs web, email, dan dokumen

API

API Markdown ke HTML untuk pengembang

Rendering berjalan sinkron dan berbiaya 0 kredit; meski begitu tetap dihitung terhadap batas permintaan per menit paket Anda. Kirim Markdown sebagai teks, atau referensikan file .md yang tersimpan, ke POST /v1/convert/markdown/html dengan kunci API Anda; HTML yang disanitasi kembali di respons yang sama.

Baca panduan 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**." }'

Panduan

Dokumentasi dan situs statis

Sebagian besar alat dokumentasi menyimpan Markdown sebagai sumber yang bisa diedit dan menghasilkan HTML hanya saat build atau pratinjau. Konverter ini memungkinkan Anda memeriksa langkah pembangkitan itu secara terpisah: tempel Markdown yang sama dengan yang akan dibaca generator situs Anda dan pastikan judul, tabel, dan blok kodenya keluar sesuai harapan tema Anda sebelum mengonfirmasi perubahan. Ini juga berguna ketika bidang CMS menerima HTML tetapi penulis Anda bekerja di Markdown: konversi sekali, tempel potongannya, dan terus edit sumber Markdown untuk revisi berikutnya alih-alih menyunting markup yang dihasilkan secara manual.

  • Pertahankan file Markdown sebagai sumber kebenaran Anda; perlakukan HTML sebagai artefak build.
  • Bandingkan keluaran yang dirender dengan tema situs Anda yang sebenarnya, bukan hanya gaya pratinjau di halaman ini.
  • Jalankan ulang konversinya setelah setiap penyuntingan sumber alih-alih menambal HTML yang dihasilkan secara manual.

Sanitasi

Markdown bisa menyematkan HTML mentah, dan HTML mentah itu bisa memuat tag <script> atau penangan peristiwa inline seperti onclick. Sebelum konverter ini mengembalikan hasil, markup itu melewati sanitizer yang menghapus elemen script, membuang atribut apa pun yang diawali "on", dan hanya mengizinkan tautan serta sumber gambar http, https, dan mailto. Yang bertahan adalah struktur semantik —judul, paragraf, daftar, tabel, tautan, gambar, dan kode—, bukan gaya dekoratif. Konverter tidak menyuntikkan kelas atau file CSS ke keluaran potongan; unduhan dokumen lengkap menambahkan tema yang Anda lihat di pratinjau agar filenya bisa dibuka sendiri dengan benar.

Potongan atau halaman lengkap

Potongan adalah markup bagian dalam —judul, paragraf, dan tabel— tanpa tag <html> atau <head> yang membungkusnya. Potongan cocok untuk halaman yang sudah menentukan struktur dokumen dan gayanya sendiri, seperti bidang konten CMS atau komponen yang merender elemen anak. Dokumen lengkap menambahkan doctype, judul, dan lembar gaya kecil agar filenya bisa dibuka langsung di browser atau disimpan sendiri. Menempelkan dokumen lengkap ke bidang konten yang mengharapkan potongan adalah kesalahan umum: browser mungkin masih merendernya, tetapi tag <html> dan <head> yang bersarang tidak valid di sana dan bisa membingungkan alat hilir yang mengharapkan potongan.

Konverter Markdown lainnya

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

FAQ

Pertanyaan tentang Markdown ke HTML

Bagaimana Markdown ke HTML bekerja?

Tempel atau tulis Markdown dan konverter merender HTML yang disanitasi secara lokal di browser Anda, dengan renderer yang sama seperti POST /v1/convert/markdown/html. Tidak ada yang diunggah saat Anda mengetik.

Apakah Markdown ke HTML mendukung GitHub Flavored Markdown?

Ya. Tabel, daftar tugas, dan coretan mengikuti spesifikasi GitHub Flavored Markdown, bersama judul, daftar, tautan, dan kode dari CommonMark.

Apakah keluaran HTML-nya disanitasi?

Ya. Tag script, penangan peristiwa inline, dan skema href atau src yang tidak aman dihapus, sehingga HTML-nya aman ditempel ke halaman yang tidak sepenuhnya Anda kendalikan.

Bisakah saya mendapatkan dokumen HTML lengkap, bukan potongan?

Bisa. Pilih dokumen lengkap dengan gaya dari pratinjau, atau salin hanya potongannya untuk halaman yang sudah punya tata letaknya sendiri.

Apakah saya perlu akun untuk mengonversi Markdown ke HTML?

Tidak. Pratinjau, penyalinan, dan pengunduhan berfungsi tanpa masuk, karena rendering berjalan secara lokal di browser Anda.

Apakah ini memanggil API saat saya mengetik?

Tidak. Mengetik tetap lokal. API hanya berjalan saat Anda memanggil POST /v1/convert/markdown/html secara langsung, misalnya dari skrip.

Apakah ada batas ukuran untuk Markdown yang saya konversi?

Tidak ada batas unggahan tetap karena tidak ada yang diunggah; batas praktisnya bergantung pada memori browser Anda untuk dokumen yang sangat besar.

Bisakah saya mengonversi Markdown ke HTML dari kode?

Bisa. Kirim Markdown Anda sebagai teks, atau file .md yang tersimpan, ke /v1/convert/markdown/html dengan kunci API. Biayanya 0 kredit. Lihat /developers.

Konversi Markdown ke HTML di mana saja.

Gratis untuk dicoba — tanpa perlu mendaftar.

MulaiBuka konverter