メインコンテンツへスキップ
見出し画像

GeminiのDeep Researchをそのまま使えるMarkdown変換ツール「AUL Research Formatter」をTypeScriptで作り直した。v2→v3へアップデート

    AIリサーチ、うまく活用できていますか?
    一つのツールに依存してませんか?
    使うツールを分散することで、事故も最小限に防げますよ笑

    Gemini Deep Researchは強力だ。数十ページ分の調査を数分でまとめてくれる。でも、コピーして貼った瞬間に気づく——改行がない。表が崩れている。見出しが消えている。

    長文が1行で続く、ただのテキストが手元に残る。

    だから作ったのがAUL Research Formatterだ。v2から使っている人もいると思うが、今回TypeScriptで全面的に書き直し、v3として公開した。

    この記事では、何が変わったのかを中心に紹介する。


    そもそもAUL Research Formatterとは

    非構造テキスト→構造テキストへの変換ツールだ。

    Gemini Deep Research(またはChatGPT、Claudeなど)が出力する長文テキストを貼ると、以下の4形式に自動変換する。

    • Markdown:ブログ・GitHub・Obsidianなどに

    • HTML:そのままWebページとして使用

    • note用:note.comのエディタに貼り付けるだけ

    • Google Docs用:ドキュメントへのインポート対応

    処理の中身はシンプルで4つだけ。

    1. 見出し検出 — タイトル:サブタイトル形式・記号(■◆▶)から自動認識

    2. 段落分割 — 改行なしテキストを句点(。!?)で復元

    3. 表検出 — パイプ区切り・スペース整形・完全フラット連結の3パターンに対応

    4. 箇条書き復元 — ・●○▸①など多様な記号を統一

    APIキー不要・インストール不要・オフライン動作。HTMLファイル1枚で完結する。


    v2との違い:何が変わったか

    1. TypeScriptで全面書き直し

    v2はバニラJavaScriptで書いていた。動いてはいたが、パーサーの中身がカオスだった。

    {t:'h', lv:2, tx:'…'}みたいなオブジェクトが型なしで飛び交っていて、block.lvを参照するときに「このblockにlvがあるかどうか」をランタイムまで確認できない状態だった。

    v3では型定義を整理した。

    type HeadingBlock  = { t: 'h'; lv: 1 | 2 | 3; tx: string };
    type ParagraphBlock = { t: 'p'; tx: string };
    type TableBlock    = { t: 'table'; headers: string[]; rows: string[][] };
    type ListBlock     = { t: 'list'; items: string[] };
    type Block = HeadingBlock | ParagraphBlock | TableBlock | ListBlock;
    

    レンダラーがswitch(block.t)で型安全に分岐できるようになった。「このケースを処理し忘れた」がコンパイル時に検出できる。

    2. Vitestでテストを書いた

    v2には自動テストが存在しなかった。つまり、パーサーを修正するたびに「なにかを壊していないか」が手動確認になっていた。

    v3では24本のテストを書いた。

    ✓ restores line breaks after Japanese sentence endings
    ✓ extracts space-separated table into markdown
    ✓ detects Gemini colon heading pattern
    ✓ recovers Gemini fully-collapsed table (no separators)
    ✓ parses ・ (middle dot) list
    ✓ escapes HTML special characters
    … 24 tests, all passed
    

    今後パーサーを拡張するとき、npm testを走らせるだけで既存動作が壊れていないことを確認できる。

    3. Geminiの「完全フラットテーブル」に対応

    v2で一番苦しかったのが、Geminiの表コピーだ。

    Geminiがコピーすると、こうなる。

    指標名数値現状備考出典全国労働力人口6,957万人2024年平均過去最高全体労働力率63.3%前年比0.4pt上昇…
    

    スペースすらない。ヘッダーとデータが完全に連結された1行。v2のスペース区切り検出では手も足も出なかった。

    v3ではTABLE_HEADER_SETSという既知ヘッダーパターン辞書を持ち、行の中に「指標名・数値・備考・出典」などのキーワードが2個以上含まれていれば表と判定する。そのうえで数字・単位の境界でデータを切り出してMarkdownテーブルに復元する。

    完璧ではないが、現実の出力の8割はこれで拾える。

    4. PREVIEWをデフォルトに変更

    v2はRAWテキスト(テキストエリア)がデフォルトで、PREVIEWは切り替えが必要だった。

    v3はPREVIEWがデフォルトだ。変換ボタンを押した瞬間、見出し・段落・テーブルがレンダリングされた状態で確認できる。RAWは「コードをそのまま見たいとき」だけ使えばいい。

    5. HTMLモードの正直な設計

    v2はHTMLモードでもPREVIEWを出そうとしていた。でも、<!DOCTYPE html>を含む完全なHTML文書をそのままinnerHTMLに流し込むと、内部CSSが干渉して表示が崩れた。

    v3ではHTMLモードのPREVIEWを「HTMLはファイルとして開いてください / DL → ブラウザにドラッグ&ドロップ」という案内に切り替えた。DLボタンが緑色にハイライトされる。正直な設計のほうが、ユーザーが迷わない。


    ビルドパイプライン:Vite + vite-plugin-singlefile

    v3はVite + TypeScriptで開発し、ビルドするとシングルHTMLファイルが出力される。

    npm run build
    # → dist/index.html(約20KB・gzip後7KB)
    

    TypeScriptで型安全に開発しながら、配布物はv2と同じ「HTMLファイルをダブルクリックして使う」形を維持できた。これがvite-plugin-singlefileを選んだ理由だ。


    使ってみた感想

    実際にGeminiの6,854文字のリサーチ出力を変換してみた。

    • 見出し 1

    • 段落 4

    • 表 3

    3秒で完了。表も正しくMarkdownテーブルになり、PREVIEWで確認してすぐコピーできた。

    この記事を書くための整形にも使った。


    無料配布

    HTMLファイル1枚をダウンロードするだけで使える。インストール不要、アカウント不要、オフライン動作。

    「このパターンが上手くいかない」という事例があれば、コメントかGitHub Issueでぜひフィードバックをもらえるとうれしい。Geminiの出力パターンは多様なので、実データで精度を上げていきたい。


    まとめ

    • Gemini Deep Researchのコピペ出力は改行なし・表崩れで使いにくい

    • AUL Research FormatterはそのテキストをMarkdown/HTML/note/Google Docs形式に変換する

    • v3ではTypeScript化・Vitest導入・完全フラットテーブル対応・PREVIEWデフォルト化を実施

    • APIキー不要・オフライン・HTMLファイル1枚で動作

    • vite-plugin-singlefileでTS開発しながら配布物はシングルHTMLを維持

    AIで調べる時代に、整形で時間を使うのはもったいない。


    AUL-DoX | 福祉・教育・ケア現場のデジタル化を支援するツール開発 note: note.com/chic_wren6567

    #GeminiDeepResearch #AIツール #Markdown変換 #TypeScript #個人開発

     
     
    AIアーキテクト(AI Architect=AIを含む仕組み全体の設計者)のAUL DoXです。60代の介護・障がい福祉の現場を知ってるこそ伝えられる、データで見る介護経営。給付費統計を発信中。その他、AIに関する記事も発信中。https://aul-dox.jp/

    あなたへのおすすめ