markitdown.ai
Başlayın

Dönüştürücü

Markdown'dan HTML'e dönüştürücü

Markdown'dan HTML'e, CommonMark ve GitHub Flavored Markdown'ı temizlenmiş HTML'e çeviren bir tarayıcı dönüştürücüsüdür — başlıklar, tablolar, görev listeleri ve çitli kod dahil. Hiçbir şey yüklenmez; aynı işleyici POST /v1/convert/markdown/html arkasında çalışır.

# 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} |

Nasıl yapılır

Markdown'dan HTML'e nasıl dönüştürülür

Neleri yapıştırabilirsiniz

  • Herhangi bir Markdown: CommonMark artı GitHub Flavored Markdown tabloları, görev listeleri ve üstü çizili metin
  • İşleme tarayıcınızda çalışır — siz yazarken hiçbir şey yüklenmez
  • Önizleme, kopyalama veya indirme için hesap gerekmez
  • Sabit boyut sınırı yok; çok büyük bir belge tarayıcınızın belleğiyle sınırlıdır
Markdown'dan HTML'e dönüştürücü: Markdown editörü solda işlenmiş HTML sayfasına dönüşür

Neden kullanılır

Bu Markdown'dan HTML'e dönüştürücüsü neden kullanılır

Bir CMS alanı, bir statik site ve bir e-posta düzenleyici, Markdown kaynağı değil biçimlendirme ister. Bu dönüştürücü, anlam taşıyan bölümleri korur ve ham HTML'i güvensiz kılacak kısımları ayıklar.

Tarayıcınızda çalışır

Markdown yapıştırın, HTML önizlemesi yerel olarak güncellenir. Hiçbir şey yüklenmez ve önizleme, kopyalama veya indirme için hesap gerekmez.

CommonMark artı GFM

Başlıklar, listeler, bağlantılar, alıntı blokları ve çitli kod CommonMark'ı izler; tablolar, görev listeleri ve üstü çizili metin GitHub Flavored Markdown'ı izler.

Varsayılan olarak temizlenmiş

Script etiketleri, satır içi olay işleyicileri ve güvensiz href veya src şemaları ayıklanır; böylece HTML, tam denetlemediğiniz bir sayfaya yapıştırmak için güvenli olur.

Parça veya tam belge

Düzenini zaten kendi yöneten bir sayfa için yalnızca işlenmiş biçimlendirmeyi kopyalayın ya da önizlenen stille eksiksiz bir HTML belgesi indirin.

Başlık çapaları

Her başlık, API'nin ürettiğiyle aynı şekilde üretilen kararlı, URL'ye uygun bir id alır; böylece bir içindekiler tablosu veya derin bağlantı yayımladıktan sonra da çalışır.

API ile aynı motor

Bu önizleme ile POST /v1/convert/markdown/html aynı işleyiciyi çalıştırır; böylece burada kopyaladığınız HTML, otomatik bir çağrıyla bayt bayt eşleşir.

Sorun

Ham Markdown neden doğrudan bir web sayfasına giremez

Markdown söz dizimi HTML değildir

Bir CMS alanı, bir e-posta şablonu veya bir statik site teması Markdown kaynağı değil biçimlendirme ister; bu yüzden ham metnin stillendirilmeden veya gömülmeden önce dönüştürülmesi gerekir.

Düz bir ayrıştırıcı GFM'i kaçırır

Tablolar, görev listeleri ve üstü çizili metin GitHub Flavored Markdown uzantılarıdır; yalnızca CommonMark kullanan bir ayrıştırıcı bunları yapı yerine düz çizgi karakterleri ve tilde işaretleri olarak işler.

Güvenilmeyen Markdown script taşıyabilir

Markdown, tam denetlemediğiniz bir sayfaya eklemeden önce ayıklanması gereken <script> etiketleri ve satır içi olay işleyicileri dahil ham HTML gömebilir.

Markdown'ı HTML'e dönüştürme: bozuk yapıştırılmış metin ile temiz Markdown yapısı yan yana

Neler korunur

Bu Markdown'dan HTML'e dönüştürücüsü neleri korur

Başlıklar ve satır içi metin
ATX ve setext başlıkları, vurgu, bağlantılar ve alıntı blokları CommonMark'ı izler; her başlık ayrıca metninden üretilen URL'ye uygun bir id alır.Source: CommonMark Spec
Tablolar, görev listeleri ve üstü çizili
GitHub Flavored Markdown tabloları <table> öğelerine dönüşür, [ ] ve [x] öğeleri onay kutusu girdilerine dönüşür ve ~~metin~~ <del> olur.Source: GitHub Flavored Markdown Spec
Temizlenmiş biçimlendirme
Ham <script> etiketleri, satır içi olay işleyicileri ve http, https ve mailto dışındaki href veya src değerleri, HTML döndürülmeden önce ayıklanır.Source: HTML Living Standard
Çitli kod
Çitli kod blokları içeriğini ve dil etiketini korur; tarayıcı önizlemesinin kendisi hiçbir söz dizimi vurgulama teması uygulamaz.Source: CommonMark Spec
Kaynaktaki ham HTML
Başka ham HTML etiketleri gömen Markdown aynı temizleyiciden geçirilir; böylece gömülü bir etiket asla güvenilir biçimlendirme olarak ele alınmaz.Source: HTML Living Standard

Doğrulanmış Markdown'dan HTML'e alıntısı· 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>

Kullanım durumları

Markdown'dan HTML'e dönüştürmenin kullanım durumları

Bir hedef, kaynak Markdown kalırken biçimlendirme istediğinde bu dönüştürücü aradaki adımdır.

Dokümantasyon ve statik siteler

Bir README'yi veya Markdown bilgi tabanı makalesini, bir statik site oluşturucunun ya da CMS alanının beklediği HTML'e çevirin.

E-posta ve bülten taslakları

Bir mesajı Markdown'da yazın, HTML'e dönüştürün, sonra parçayı gerçekte gönderdiğiniz e-posta düzenleyicisine yapıştırın.

Bir LLM yanıtını temizleme

ChatGPT, Claude ve Gemini Markdown döndürür; hedef — bir destek kaydı, bir wiki sayfası — ham yıldız işaretleri yerine biçimlendirme işlediğinde bunu HTML'e çevirin.

İşlemeyi otomatikleştiren geliştiriciler

Markdown saklayıp HTML sunan bir iş akışından işleme uç noktasını çağırın; her hizmete bir Markdown kitaplığı eklemenize gerek kalmaz.

Markdown'dan HTML'e: işlenmiş sayfa web sitelerinde, e-postada ve belgelerde kullanılır

API

Geliştiriciler için Markdown'dan HTML'e API'si

İşleme eşzamanlı çalışır ve 0 kredi tutarındadır — yine de planınızın dakika başına hız sınırına sayılır. Markdown'ı metin olarak gönderin ya da depolanmış bir .md dosyasına başvurun; API anahtarınızla POST /v1/convert/markdown/html adresine iletin; temizlenmiş HTML satır içinde döner.

API kılavuzunu okuyun
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**." }'

Kılavuz

Dokümantasyon ve statik siteler

Çoğu dokümantasyon aracı, düzenlenebilir kaynak olarak Markdown'ı tutar ve HTML'i yalnızca derleme ya da önizleme sırasında üretir. Bu dönüştürücü, o üretim adımını tek başına denetlemenizi sağlar: site oluşturucunuzun okuyacağı aynı Markdown'ı yapıştırın ve bir değişikliği göndermeden önce başlıkların, tabloların ve kod bloklarının temanızın beklediği gibi çıkıp çıkmadığını doğrulayın. Bir CMS alanı HTML kabul ederken yazarlarınız Markdown'da çalıştığında da yararlıdır — bir kez dönüştürün, parçayı yapıştırın ve sonraki sürüm için üretilmiş biçimlendirmeyi elle düzenlemek yerine Markdown kaynağını düzenlemeye devam edin.

  • Markdown dosyasını doğruluk kaynağınız olarak tutun; HTML'i bir derleme çıktısı olarak ele alın.
  • İşlenmiş çıktıyı yalnızca bu sayfanın önizleme stiliyle değil, sitenizin gerçek temasıyla karşılaştırın.
  • Üretilmiş HTML'i elle yamamak yerine her kaynak düzenlemesinden sonra dönüştürmeyi yeniden çalıştırın.

Temizleme

Markdown ham HTML gömebilir ve bu ham HTML bir <script> etiketi ya da onclick gibi bir satır içi olay işleyicisi içerebilir. Bu dönüştürücü bir sonuç döndürmeden önce, o biçimlendirme script öğelerini kaldıran, "on" ile başlayan her özniteliği ayıklayan ve yalnızca http, https ve mailto bağlantılarına ve görsel kaynaklarına izin veren bir temizleyiciden geçirilir. Ayakta kalan, anlamsal yapıdır — başlıklar, paragraflar, listeler, tablolar, bağlantılar, görseller ve kod — dekoratif stil değil. Dönüştürücü, parça çıktısına bir sınıf ya da bir CSS dosyası enjekte etmez; tam belge indirmesi, önizlemede gördüğünüz temayı ekler; böylece dosya tek başına doğru açılır.

Parça veya tam sayfa

Parça, iç biçimlendirmedir — başlıklar, paragraflar ve tablolar — çevresinde <html> veya <head> olmadan. Kendi belge yapısını ve stilini zaten tanımlayan bir sayfanın içine aittir; örneğin bir CMS içerik alanı ya da alt öğeleri işleyen bir bileşen. Tam belge bir doctype, bir title ve küçük bir stil sayfası ekler; böylece dosya doğrudan bir tarayıcıda açılabilir ya da tek başına kaydedilebilir. Bir parça bekleyen içerik alanına tam belge yapıştırmak yaygın bir hatadır: tarayıcı yine de işleyebilir, ancak iç içe <html> ve <head> etiketleri orada geçersizdir ve parça bekleyen sonraki araçları şaşırtabilir.

Daha fazla Markdown dönüştürücüsü

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

SSS

Markdown'dan HTML'e soruları

Markdown'dan HTML'e nasıl çalışır?

Markdown yapıştırın veya yazın; dönüştürücü, POST /v1/convert/markdown/html ile aynı işleyiciyi kullanarak temizlenmiş HTML'i tarayıcınızda yerel olarak işler. Siz yazarken hiçbir şey yüklenmez.

Markdown'dan HTML'e GitHub Flavored Markdown'ı destekler mi?

Evet. Tablolar, görev listeleri ve üstü çizili metin, CommonMark başlıkları, listeleri, bağlantıları ve koduyla birlikte GitHub Flavored Markdown belirtimini izler.

HTML çıktısı temizlenmiş mi?

Evet. Script etiketleri, satır içi olay işleyicileri ve güvensiz href veya src şemaları ayıklanır; böylece HTML, tam denetlemediğiniz bir sayfaya yapıştırmak için güvenli olur.

Parça yerine tam bir HTML belgesi alabilir miyim?

Evet. Önizlenen stille eksiksiz bir belge seçin ya da düzenini zaten kendi yöneten bir sayfa için yalnızca parçayı kopyalayın.

Markdown'dan HTML'e dönüştürmek için hesap gerekli mi?

Hayır. Önizleme, kopyalama ve indirme, işleme tarayıcınızda yerel olarak çalıştığı için oturum açmadan çalışır.

Bu, ben yazarken API'yi çağırıyor mu?

Hayır. Yazma yerel kalır. API yalnızca POST /v1/convert/markdown/html'i doğrudan, örneğin bir betikten çağırdığınızda çalışır.

Dönüştürdüğüm Markdown için bir boyut sınırı var mı?

Hiçbir şey yüklenmediği için sabit bir yükleme sınırı yoktur; pratik sınırlar, çok büyük belgelerde tarayıcınızın belleğine bağlıdır.

Markdown'ı koddan HTML'e dönüştürebilir miyim?

Evet. Markdown'ınızı metin olarak ya da depolanmış bir .md dosyasını bir API anahtarıyla /v1/convert/markdown/html adresine POST edin. 0 kredi tutarındadır. /developers sayfasına bakın.

Markdown'ı her yerde HTML biçimine dönüştürün.

Denemesi ücretsiz — kayıt gerekmez.

BaşlayınDönüştürücüyü açın