docmd

docmdの実体

docmd(github.com/docmd-io/docmd)は、Markdownのフォルダーをドキュメントサイトに変換するNode製CLIです。`npx @docmd/core dev` はMarkdownがあるフォルダーならどこでも動き、設定ファイルなし・frontmatter必須なし・ディレクトリ構造から導かれるナビゲーションでlocalhostに配信します。`npx @docmd/core build` はどこにでもホストできる静的サイトを書き出します。ライセンスはリポジトリのLICENSEファイルに置かれた素直なMIT、プロジェクトの開始は2025年5月、リリース履歴は散発的ではなく安定していて、2026年7月15日の0.8.15から2026年8月23日の0.9.4まで続き、取得時点でのオープンIssueは14件でした。

• 設定ゼロで動き出す 設定ファイルは一切不要です。タイトルや正規URL、入出力ディレクトリを変えたいときのために `docmd.config.json` がありますが、動的な値が必要ならTypeScriptやJavaScriptでも書けます。
• AI向け出力は追加機能ではなくコアプラグイン `llms`、`okf`、`search`、`seo`、`sitemap` の各プラグインは既定で有効です。つまりコンテキストファイルもサイトマップも、誰かが覚えておくべき追加手順ではなく通常のビルドの産物として出てきます。
• 移行手段が最初から入っている `docmd migrate` は既存のDocusaurus、VitePress、MkDocs、Starlightの構成を変換します。重要なのは、試すことが書き直しから始まらないという点です。
• 多言語とバージョンを一級のビルドとして扱う 多言語ビルドは言語ごとの検索インデックス、言語ごとのコンテキストファイル、hreflangタグを生成し、ドキュメントのバージョン管理はプラグインではなくネイティブ機能です。すでにサイトを翻訳しているなら、採否を決めるのはここです。
• NodeのバージョンはREADMEではなくパッケージで確認する READMEはNode.js 18以上と書いていますが、公開されている `@docmd/core` パッケージは `engines.node >= 20.0.0` を宣言しています。18のままのマシンでは、教えてくれるのはインストール時なので、20を前提にしてください。

ホスティング側の要素もあるので、採用前に線引きを知っておく価値があります。AIアシスタントのプラグインは、自前のAPIキーかローカルモデルを使って自分のドキュメントを検索拡張しながらチャットします。cloud.docmd.ioのCloud Relayは、純粋な静的サイトでもバックエンドを立てずにそのアシスタントを動かすために存在します。コンパイラと以下のすべての成果物はMITのリポジトリの中にあり、relayだけが任意のホスト型の便利機能 — つまりオープンコアの縮図です。

機械向けの4つの成果物と、その読み手

このリストが見た目以上の価値を持つ理由があります。私たちはAgentCeres — AIグロースオフィサー、agentceres.com — のために `llms.txt` と `llms-full.txt` を公開していますが、どちらも手書きでした。そして内容がずれました。顧客が実際には選べない社内向けロールが載り、私たちが一度も販売したことのないシート単価の料金表が載っていたのです。数週間気づかれませんでした。マーケティング文言を守るチェックはアプリケーションのソースディレクトリを走査しますが、この2つのファイルは静的な `public/` フォルダーにあり、どのチェックもそこを読まないからです。生成されたコンテキストファイルは、この種の誤りを構造として丸ごと消します。生成のほうが賢いからではなく、古びる余地のある2つ目のコピーが残らないからです。

見つけてもらう文脈でどこに効くか

ドキュメントは、小さなチームが書くもののうち回答エンジンがそのまま使える数少ない素材です。具体的で、日付があり、他の誰にもこれほど正確には書けない製品の説明だからです。だからこそ生成エンジン最適化の原料として優秀で、docmdはそれを取得可能にするコストをほぼゼロまで下げます。もっと広くChatGPTに自社を引用してもらう方法が問いなら、これはその入力の1つであって答えではありません。

限界もはっきりさせておきます。過大評価しやすいところだからです。コンテキストファイルの出力はドキュメントの取得を安くしますが、モデルにあなたを選ばせはしませんし、どんなビルド手順にもそれはできません。しかも対象はドキュメントだけです。料金ページ、比較ページ、ランディングページは別のコーパスで別の問題を抱えており、買い手の質問が実際に着地するのはたいていそちらです。必要なのが機械可読な半分ではなくドキュメントサイトそのものなら、Docusaurusのほうが手堅く、別ページで扱っています。

創業者にとって正直な順序はこうです。ユーザーが必要としているからドキュメントを書き、コンテキストファイルは無料の副産物として受け取り、流入は数か月かかるかもしれない二次的効果として扱う。ファイルの公開はビルドのフラグ1つです。引用に値するかどうかが仕事であり、その部分は今も書くことです。そこでAgentCeresがあなたと並んで下書きし、外に出るものは人が承認します。