Repolode
alchaincyf

alchaincyf/huashu-md-html

ファイルやWebページをMarkdownに変換し、Markdownを装飾済みHTMLや印刷用DOCXに変換、HTMLをMarkdownに戻して保存できるClaude Code風のスキルです。

スター
920
フォーク
98
未解決の Issue
6
最終コミット
8 日前

これは何?

huashu-md-htmlは、エージェントスキルとして提供される変換スクリプト群です。markitdownを使って、PDF、DOCX、PPTX、XLSX、EPUB、画像、音声、YouTube動画、Web URLをMarkdownに変換します。また、Pandocをベースにした4種類の単一ファイルテーマ(article、report、reading、interactive)を使って、MarkdownをHTMLに変換できます。

逆方向の変換では、html-to-markdownとtrafilaturaを使い、公開済みHTMLページやURLから本文を抽出してMarkdownに戻します。ナビゲーションやサイドバーも取り除きます。別のスクリプトでは、表紙、目次、ヘッダーとフッター、章ごとの改ページ、32開またはA4のページサイズに対応した書籍向けプリセットを使って、MarkdownからDOCXを作成します。

npx skills addでインストールでき、Claude CodeやCursorなど複数のエージェントで使えるよう設計されています。スクリプトは起動時に依存関係を確認し、不足しているパッケージがあれば、エラーを黙って無視せずに通知します。

主な機能

  • 01PDF、Officeファイル、EPUB、画像、音声、YouTube、Web URLをMarkdownに変換します。
  • 02外部CDNが不要な、自己完結型の4種類のテーマを使ってMarkdownをHTMLに変換します。
  • 03Webページから記事本文を抽出し、ナビゲーション、サイドバー、広告を取り除きます。
  • 04表紙、目次、ヘッダー、フッター、章ごとの改ページを備えた書籍形式のDOCXを作成します。
  • 05npx skills addでインストールでき、複数のエージェントで使えるスキルとして動作します。

ユースケース

  • PDFのホワイトペーパーをreportテーマで読みやすいHTMLページに変換する。
  • 公開済みのブログ記事をMarkdownソースとして保存する。
  • 編集者や投稿システムに提出するための、書式を整えた原稿DOCXを作成する。
  • Web上のドキュメントページを、AIアシスタント向けの構造化されたMarkdownに変換する。

クイックスタート

  1. 1

    skills.sh でスキルをインストールする

    npx skills add alchaincyf/huashu-md-html
  2. 2

    markitdown 用の Python 依存関係をインストールする

    python3 -m pip install 'markitdown[all]'
  3. 3

    pandoc をインストールする(README にある macOS の例)

    brew install pandoc
  4. 4

    Markdown ファイルをスタイル付きの HTML ページに変換する

    python3 scripts/md_to_html.py article.md --theme article -o article.html

使う前に知っておきたいこと

  • Python 3 と pandoc などの複数の外部ツールが必要です。また、一部の機能には追加の pip パッケージが必要です。
  • エージェントスキルとして実行するよう設計されており、単体で使える GUI はありません。

トピック

よくある質問

huashu-md-html とは?
ファイルやWebページをMarkdownに変換し、Markdownを装飾済みHTMLや印刷用DOCXに変換、HTMLをMarkdownに戻して保存できるClaude Code風のスキルです。 huashu-md-htmlは、エージェントスキルとして提供される変換スクリプト群です。markitdownを使って、PDF、DOCX、PPTX、XLSX、EPUB、画像、音声、YouTube動画、Web URLをMarkdownに変換します。また、Pandocをベースにした4種類の単一ファイルテーマ(article、report、reading、interactive)を使って、MarkdownをHTMLに変換できます。
huashu-md-html は無料で使えますか?ライセンスは?
huashu-md-html は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
huashu-md-html は今もメンテナンスされていますか?
活発にメンテナンス中。huashu-md-html の最終コミットは 2026年10月13日 です。
huashu-md-html は何に使えますか?
PDFのホワイトペーパーをreportテーマで読みやすいHTMLページに変換する。 公開済みのブログ記事をMarkdownソースとして保存する。 編集者や投稿システムに提出するための、書式を整えた原稿DOCXを作成する。 Web上のドキュメントページを、AIアシスタント向けの構造化されたMarkdownに変換する。
huashu-md-html のインストール方法は?
skills.sh でスキルをインストールする: npx skills add alchaincyf/huashu-md-html markitdown 用の Python 依存関係をインストールする: python3 -m pip install 'markitdown[all]' pandoc をインストールする(README にある macOS の例): brew install pandoc Markdown ファイルをスタイル付きの HTML ページに変換する: python3 scripts/md_to_html.py article.md --theme article -o article.html
huashu-md-html はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/alchaincyf/huashu-md-html

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト