Communitygithub.com

razpetel/html-to-notion

リッチなHTMLをNotionにインポート可能なMarkdownに変換するClaude Codeスキル&CLI。Mermaid図、テーブル、コールアウト、CSSビジュアルコンポーネントを保持します。

html-to-notion とは?

razpetel/html-to-notionは、複雑なHTMLコンテンツをNotionで直接利用できるMarkdown形式に変換するためのClaude Codeスキルおよびコマンドラインツールです。このスキルは、Mermaidダイアグラム、テーブル、コールアウト、CSSによる視覚的要素など、豊富なHTMLコンポーネントを正確に変換・保持することに特化しています。主にClaude Code環境で動作し、開発者やコンテンツ作成者がWebスクレイピングや既存のHTMLドキュメントをNotionワークスペースに簡単に移行できるように設計されています。変換処理は構造解析とマークダウン生成の二段階で行われ、CSSスタイルに基づく視覚的コンポーネントの類推と再現を可能にします。

対応✓Claude Code~Codex CLI~Cursor
npx skills add razpetel/html-to-notion

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

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ファイルを読み込んでください

関連スキル