なぜ私は MarkFlow を作ったのか：開発者の日記
あの火曜日の夜のことを今でも覚えています。夜の11時、私は新しいAPIの技術文書を書き終えたところでした。
Markdownで書かれたその文書は美しく、きれいな構造、完璧なコードブロック、そしてデータの流れを説明する有効なMermaid図が含まれていました。README.md が完璧に仕上がったとき、すべての開発者が知っているあの満足感を感じていました。
その時、プロジェクトマネージャーからSlackの通知が届きました。
「ねえ、ドキュメントお疲れ様。これをWord文書で送ってくれる？法務チームが『変更履歴の記録』機能を使ってレビューする必要があるんだけど、彼らはMarkdownを使わないんだ。」
私はため息をつきました。「わかりました、5分ください。」
それが「最後の言葉」になるとは知らずに。
「5分」の悪夢
私はターミナルを開き、Pandocコマンドを実行しました。
pandoc docs.md -o docs.docx
Wordで結果を開きました。私の心は沈みました。
- 表が壊れている。 列がつぶれ、ヘッダーがずれていました。
- 図が消えている。 私の美しいMermaidチャートは、ただのむき出しのコードブロックになっていました。
- シンタックスハイライトが消えている。 Pythonコードはただのプレーンテキストのように見え、読みにくいものでした。
「よし」と私は思いました。「オンラインコンバーターを試してみよう。」
私は「Markdown to Word converter」とかぐぐって、最初の結果をクリックしました。ファイルを アップロード するように求められました。私は手を止めました。この文書には内部APIエンドポイントと独自のロジックが含まれていました。明確なプライバシーポリシーのないランダムなサーバーにこれをアップロードするわけにはいきません。
そこで、私は絶望的な開発者がすることを行いました。片方の画面にWordを開き、もう片方にVS Codeを開いて、手動でコピー＆ペーストを始めました。
次の 2時間、私は手動でリストをインデントし、図のスクリーンショットを撮って画像として貼り付け、太字スタイルを再適用しました。午前1時までに、私は疲れ果て、イライラしていました。私はコーディングをしていたのではなく、ワードプロセッサと戦っていたのです。
気づき
その夜、私は2つのことに気づきました。
- Markdownは執筆には最高だが、世界はWordで動いている。 私たちはそれから逃れることはできません。
- 既存のツールは選択を強いる： PandocのようなCLIツールを設定するのに何時間も費やすか、クラウドコンバーターにプライバシーを犠牲にするか。
私はどちらも望みませんでした。私は プライバシーを尊重し（ローカル処理）、フォーマットを尊重する（GFMサポート）ツールが欲しかったのです。
そこで、私は MarkFlow を作りました。
自分（そしてあなた）のために作る
私は自分のための小さなユーティリティとしてMarkFlowを作り始めました。目標はシンプルでした。
- ローカルであること。 機密保持契約書や広範なドキュメントを、データがブラウザから出ることなく変換したい。
- 「厄介な」ものを処理できること。 表、タスクリスト、そしてもちろん、コードブロックのシンタックスハイライト。
- 高速であること。 ドラッグ、ドロップ、完了。
最初のバージョンを同僚に見せたとき、彼女の目が輝きました。「待って、表のフォーマットがそのままなの？Pythonをインストールする必要もないの？」
その時、私はこれが私のラップトップ上の単なるスクリプトであってはならないと知りました。
なぜ「ローカルファースト」が重要なのか
2026年において、データプライバシーは贅沢品ではなく、必須要件です。私はMarkFlowを、変換エンジンが Webブラウザ内 で直接実行される独自のアーキテクチャで構築しました。
あなたがMarkFlowを使用するとき、あなたは私にファイルを送信しているわけではありません。あなたは本質的に、たまたまウェブサイト上にある強力なアプリを使用しているに過ぎません。つまり、NDA、特許草案、個人の日記 をデータ漏洩の恐れなしに変換できるということです。
私のフラストレーションから、あなたの生産性へ
今日、MarkFlowはあの深夜のフラストレーションから、何千人ものユーザーに信頼される堅牢なツールへと成長しました。
- 壊れた表はもうありません。
- コードの色が消えることもありません。
- プライバシーの不安もありません。
私がこれを作ったのは、あなたが火曜日の夜にWordのフォーマットと戦う必要がないようにするためです。あなたはコンテンツに集中してください。プレゼンテーションはMarkFlowに任せてください。
最新の .md ファイルで試してみてください。私が決して取り戻せないあの2時間を、あなたが節約できることを願っています。
— MarkFlow 開発者
役に立ちましたか？共有して広めましょう。