flowdoc：以預設驅動產出 PRISMA／CONSORT／STROBE 指引流程圖的零相依工具

Tue, 28 Apr 2026 00:00:00 +0000

# Introduction（引言）

PRISMA 2020、CONSORT 2010 與 STROBE 為三大研究報告指引，要求作者以標準化流程圖呈現受試者納入、隨機分派與分析流程。然而臨床研究者多以 PowerPoint 或 draw.io 手動繪製，導致排版不一致、圖中數字易誤抄，且難以納入版本控制。雖有商業 LaTeX 套件可協助，但多數對非程式背景使用者門檻過高。本專案以「資料即圖」為核心，將流程圖視為從結構化資料生成的衍生物。

# Methods（方法）

flowdoc 以 TypeScript 實作，刻意維持零執行期相依：使用者僅需提供符合預設 schema 的 JSON 或 YAML，即可獲得可選格式的輸出（SVG、drawio、Mermaid、PDF、PNG）。系統內建 PRISMA 2020、CONSORT 2010 與 STROBE 等指引的標準節點與連線預設，使用者只需填入對應數字與標籤，即可產出符合期刊要求的流程圖。

設計上強調確定性：相同輸入永遠產出相同輸出，便於版本控制與同儕審查；同時提供多種輸出格式，覆蓋從投稿（向量 SVG／PDF）到簡報（PNG）與後續編輯（drawio）的需求。

# Results（結果）

工具可在數秒內產出三大指引所需流程圖，並能與 Quarto、Markdown 與 LaTeX 投稿管線無縫整合。對於系統性回顧研究團隊，這顯著縮短「從擷取資料到完成圖表」的時間；對於審查者而言，純文字輸入亦提高審查透明度。零相依特性使其可在 CI／CD 環境中自動產出最新版本流程圖。

# Discussion（討論）

本專案具體實踐了「圖即文件」的觀念：將流程圖從藝術創作回歸為資料表達，符合 reproducible research 的精神。限制方面，目前預設僅涵蓋三大指引，更新後的版本（如 PRISMA 2020 子型別）需要持續維護；高度自訂化的版型仍需手動 SVG 編輯。未來可擴充至 SPIRIT、CARE 與其他 EQUATOR Network 指引，並結合 LLM 由原始研究文件半自動填寫節點數字。

# 連結