markitdown.ai
はじめる

変換ツール

Markdown HTML 変換ツール

Markdown から HTML は、CommonMark と GitHub Flavored Markdown をサニタイズ済みの HTML に変えるブラウザコンバーターです。見出し、表、タスクリスト、フェンス付きコードを含みます。何もアップロードしません。同じレンダラーが 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

見出し、リスト、リンク、引用、フェンス付きコードは CommonMark に従います。表、タスクリスト、取り消し線は GitHub Flavored Markdown に従います。

既定でサニタイズ

script タグ、インラインのイベントハンドラー、安全でない href や src スキームは取り除かれるので、この HTML は完全には管理していないページに貼り付けても安全です。

フラグメントまたは完全なドキュメント

すでにレイアウトを持つページ向けにはレンダリングされたマークアップだけをコピーし、プレビューのスタイルを含む完全な HTML ドキュメントをダウンロードすることもできます。

見出しアンカー

各見出しには、API と同じ方法で生成される安定した URL 安全な id が付くので、公開後も目次やディープリンクが機能します。

API と同じエンジン

このプレビューと POST /v1/convert/markdown/html は同じレンダラーを実行するので、ここでコピーした HTML は自動化呼び出しとバイト単位で一致します。

課題

生の Markdown をそのまま Web ページに置けない理由

Markdown の構文は HTML ではない

CMS のフィールド、メールテンプレート、静的サイトのテーマは、Markdown ソースではなくマークアップを求めるので、生のテキストはスタイルを当てたり埋め込んだりする前に変換が必要です。

普通のパーサーは GFM を取りこぼす

表、タスクリスト、取り消し線は GitHub Flavored Markdown の拡張です。CommonMark だけのパーサーは、それらを構造ではなく文字どおりのパイプ記号やチルダとしてレンダリングします。

信頼できない Markdown はスクリプトを運び得る

Markdown は生の HTML を埋め込めます。そこには <script> タグやインラインのイベントハンドラーが含まれ得るので、完全には管理していないページに挿入して安全になる前に取り除く必要があります。

Markdown を HTML に変換：崩れたコピペ文と整った Markdown 構造の比較

保たれるもの

この Markdown HTML 変換ツールが保持するもの

見出しとインラインテキスト
ATX と setext の見出し、強調、リンク、引用は CommonMark に従います。各見出しには、そのテキストから生成される URL 安全な id も付きます。Source: CommonMark Spec
表、タスクリスト、取り消し線
GitHub Flavored Markdown の表は <table> 要素に、[ ] と [x] の項目はチェックボックス入力に、~~text~~ は <del> になります。Source: GitHub Flavored Markdown Spec
サニタイズ済みのマークアップ
生の <script> タグ、インラインのイベントハンドラー、http、https、mailto 以外の href や src の値は、HTML を返す前に取り除かれます。Source: HTML Living Standard
フェンス付きコード
フェンス付きコードブロックは内容と言語ラベルを保持します。ブラウザのプレビュー自体は、シンタックスハイライトのテーマを適用しません。Source: CommonMark Spec
ソース内の生の HTML
他の生の HTML タグを埋め込んだ Markdown も同じサニタイザーを通るので、埋め込まれたタグが信頼されたマークアップとして扱われることはありません。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 のまま、というあらゆる場面で、このコンバーターが間の 1 ステップになります。

ドキュメントと静的サイト

README や Markdown のナレッジベース記事を、静的サイトジェネレーターや CMS フィールドが期待する HTML に変えます。

メールとニュースレターの下書き

Markdown でメッセージを下書きし、HTML に変換して、実際に送信するメールエディターにフラグメントを貼り付けます。

LLM の回答の整理

ChatGPT、Claude、Gemini は Markdown を返します。出力先 — チケットや wiki ページ — が生のアスタリスクではなくマークアップをレンダリングするときは、HTML に変換します。

レンダリングを自動化する開発者

Markdown を保存しつつ HTML を配信するパイプラインからレンダリングエンドポイントを呼び出し、すべてのサービスに Markdown ライブラリを足す手間を省きます。

Markdown HTML 変換ツール：HTML ページを Web サイト、メール、ドキュメントに利用

API

開発者向けの Markdown HTML 変換 API

レンダリングは同期で実行され、0 クレジットです — それでもプランの毎分レート制限にはカウントされます。Markdown をテキストとして送るか、保存済みの .md ファイルを参照して、API キーとともに POST /v1/convert/markdown/html に送ると、サニタイズ済みの 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 を生成します。このコンバーターを使えば、その生成ステップを単独で確認できます。サイトジェネレーターが読み込むのと同じ Markdown を貼り付け、変更をコミットする前に、見出し、表、コードブロックがテーマの期待どおりに出るかを確かめます。CMS フィールドが HTML を受け付けるのに、書き手が Markdown で作業している場合にも便利です — 一度変換してフラグメントを貼り付け、次の版では生成されたマークアップを手で編集するのではなく Markdown ソースを編集し続けます。

  • Markdown ファイルを信頼できる唯一のソースとして保ち、HTML はビルド成果物として扱う。
  • レンダリング結果は、このページのプレビュースタイルだけでなく、あなたのサイトの実際のテーマと比較する。
  • ソースを編集するたびに変換をやり直し、生成された HTML を手作業で修正しない。

サニタイズ

Markdown は生の HTML を埋め込め、その生の HTML には <script> タグや onclick のようなインラインのイベントハンドラーが含まれ得ます。このコンバーターが結果を返す前に、そうしたマークアップはサニタイザーを通ります。script 要素を取り除き、"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.

FAQ

Markdown HTML 変換のよくある質問

Markdown から HTML はどう動きますか？

Markdown を貼り付けるか入力すると、コンバーターが POST /v1/convert/markdown/html と同じレンダラーを使って、サニタイズ済みの HTML をブラウザ内でローカルにレンダリングします。入力中は何もアップロードされません。

Markdown から HTML は GitHub Flavored Markdown に対応していますか？

はい。表、タスクリスト、取り消し線は GitHub Flavored Markdown 仕様に従い、CommonMark の見出し、リスト、リンク、コードと並んで使えます。

出力される HTML はサニタイズされていますか？

はい。script タグ、インラインのイベントハンドラー、安全でない href や src スキームは取り除かれるので、この HTML は完全には管理していないページに貼り付けても安全です。

フラグメントではなく完全な HTML ドキュメントを取得できますか？

はい。プレビューのスタイルを伴う完全なドキュメントを選ぶか、すでにレイアウトを持つページ向けにフラグメントだけをコピーします。

Markdown から HTML への変換にアカウントは必要ですか？

いいえ。レンダリングはブラウザ内でローカルに実行されるので、プレビュー、コピー、ダウンロードはすべてサインインなしで機能します。

入力中に API を呼びますか？

いいえ。入力はローカルにとどまります。API は、たとえばスクリプトから POST /v1/convert/markdown/html を直接呼び出したときにだけ動きます。

変換する Markdown にサイズ制限はありますか？

何もアップロードしないので固定のアップロード上限はありません。実際の上限は、非常に大きい文書に対するブラウザのメモリ次第です。

コードから Markdown を HTML に変換できますか？

はい。Markdown をテキストとして、または保存済みの .md ファイルを、API キーとともに /v1/convert/markdown/html に POST します。0 クレジットです。[/developers](/developers) をご覧ください。

Markdown を HTML にどこでも変換。

無料で試せます。登録は不要です。

はじめる変換ツールを開く