html-to-notion は何をしますか?
Claude Codeスキル&CLI — リッチなHTMLをNotionにインポート可能なMarkdownに変換します。Mermaid図、テーブル、コールアウト、CSSビジュアルコンポーネントを保持します。
概要
このスキルは、複雑なHTMLコンテンツをNotionがサポートするMarkdown形式に変換するためのツールです。Webページのスクレイピング結果やHTMLドキュメントを、Notionデータベースやページにそのままインポートできる形式に変換します。
特徴
- Mermaid図の保持: HTML内のMermaidコードブロック(
<pre><code class="language-mermaid">)をそのまま保持 - テーブルの変換: HTMLテーブルをMarkdownテーブルに変換
- コールアウトの変換: 特定のCSSクラスやスタイルに基づいて、コールアウト(注意、ヒントなど)をNotionスタイルのブロッククォートに変換
- CSSビジュアルコンポーネント: CSSスタイル(背景色、ボーダー、アイコンなど)を解析し、Notionの対応する要素に変換
使用方法
Claude Code での使用
スキルを読み込んだ状態で、以下のようなプロンプトを実行します:
/path/to/input.html を Notion Markdown に変換してください
または、特定のHTML文字列を直接指定:
以下のHTMLをNotion Markdownに変換してください:
[HTMLコード]
CLI としての使用
html-to-notion input.html -o output.md
変換ルール
| HTML要素 | Notion Markdown |
|---|---|
<h1>...<h6> | #...###### 見出し |
<p> | 段落 |
<table> | Markdownテーブル |
<pre><code class="language-mermaid"> | Mermaidコードブロック |
CSSクラス callout | > **メモ:** 形式のブロッククォート |
注意事項
- 画像はNotionの外部リンクとして保持されます(埋め込みはされません)
- 非常に複雑なCSSレイアウトは完全に再現できない場合があります
- 変換後はNotionの「インポート」機能を使ってMarkdownファイルを読み込んでください