
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つだけ。
見出し検出 — タイトル:サブタイトル形式・記号(■◆▶)から自動認識
段落分割 — 改行なしテキストを句点(。!?)で復元
表検出 — パイプ区切り・スペース整形・完全フラット連結の3パターンに対応
箇条書き復元 — ・●○▸①など多様な記号を統一
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