github.com/docmd-io/docmd @0.8.9

^{EN  |  ES  |  DE  |  日本語  |  FR  |  中文}

  <img src="https://github.com/docmd-io/docmd/blob/main/packages/ui/assets/images/docmd-logo-dark.png?raw=true" alt="docmd" width="210" />

Markdown から数秒でプロダクション品質のドキュメントを。

Zero config。AI ネイティブ。開発者のために。

<a href="https://www.npmjs.com/package/@docmd/core"><img src="https://img.shields.io/npm/v/@docmd/core.svg?style=flat-square&color=CB3837" alt="npm version"></a>
<a href="https://www.npmjs.com/package/@docmd/core?activeTab=versions"><img src="https://img.shields.io/npm/dm/@docmd/core.svg?style=flat-square&color=38bd24" alt="monthly downloads"></a>
<a href="https://github.com/docmd-io/docmd"><img src="https://img.shields.io/github/stars/docmd-io/docmd?style=flat-square&logo=github" alt="GitHub stars"></a>
<a href="https://github.com/docmd-io/docmd/blob/main/LICENSE"><img src="https://img.shields.io/github/license/docmd-io/docmd.svg?style=flat-square&color=A31F34" alt="license"></a>

ウェブサイト  ·  ドキュメント  ·  ライブエディタ  ·  Agent Skills  ·  バグ報告

クイックスタート

Markdown ファイルがある任意のフォルダで docmd を実行 — インストール不要：

npx @docmd/core dev

http://localhost:3000 で開きます

    _                 _
  _| |___ ___ _____ _| |
 | . | . |  _|     | . |
 |___|___|___|_|_|_|___|

 v1.x.x

┌─ Build
│  Engine          JS
│  Source          docs/
│  Output          site/
│  Versions        2 (06, 05)
│  Locales         7 (en, hi, zh, es, de, ja, fr)
└──────────────────────────────────────────────────────────
┌─ Data Indexing
│  [ DONE ] Syncing git metadata
│  [ DONE ] Building semantic search index (multi-version)
└──────────────────────────────────────────────────────────
┌─ Publishing
│  [ DONE ] Generated robots.txt
│  [ DONE ] Generated .nojekyll (disables Jekyll on GitHub Pages)
│  [ DONE ] Generated sitemap
│  [ DONE ] Generating LLMs context files
└──────────────────────────────────────────────────────────

⬢ Initial build completed in 1.2s.

┌─ Watching
│  Source          ./docs
│  Config          ./docmd.config.json
│  Assets          ./assets
└──────────────────────────────────────────────────────────
┌─ Development Server Running
│  Local Access    http://127.0.0.1:3000
│  Network Access  http://192.168.1.6:3000
│  Serving from    ./site
└──────────────────────────────────────────────────────────

ナビゲーションはファイル構造から自動生成されます。設定ファイル不要、frontmatter 必須なし、学ぶべきフレームワークもありません。

公開の準備ができたら：

npx @docmd/core build

これは Vercel、Cloudflare Pages、Netlify、GitHub Pages、その他の静的ホストにデプロイ可能な、高度に最適化された静的サイト（SPA）を出力します。

要件： Node.js 18+

またはグローバルインストール / Docker 経由

# npm でグローバルインストール
npm install -g @docmd/core

# または pnpm
pnpm add -g @docmd/core

# 実行
docmd dev    # dev サーバーを起動
docmd build  # デプロイ用にビルド

または Docker 経由：

docker run -p 3000:3000 ghcr.io/docmd-io/docmd:0.8.7

再現可能なビルドのためにバージョンを固定してください。

なぜ docmd？

機能

Zero config、即時スタート

任意の Markdown フォルダを docmd に指定するだけで実行できます。ナビゲーションはファイル構造から自動生成されます。最初のドキュメントを書いて 1 分以内に公開可能 — ボイラープレートなし、ビルドパイプラインの設定なし、事前の意思決定は不要です。

標準で軽量、どこでも高速

デフォルトの JavaScript ペイロードは ~18 kb。ページは即時 SPA としてナビゲートします。出力は静的 HTML — SEO 最適化済み、sitemap、正規 URL、Open Graph メタデータを含む。オフラインの全文検索を内蔵、クラウドサービス不要。

AI ネイティブ

docmd は今ドキのドキュメントの読み方・使われ方に合わせて構築されています： - MCP サーバー — docmd mcp がドキュメントを stdio 経由で AI Agent に公開し、検索・読み取り・検証を直接行えます。 - コンテキスト (llms.txt / llms-full.txt) — ビルド時に生成される完全なドキュメントコンテキスト、あらゆる LLM で即利用可能。 - Agent Skills — LLM と IDE Agent 向けのモジュール式インストラクショセット (docmd-skills)。 - Markdown としてコピー / コンテキストをコピー — ブラウザ内のワンクリックボタン。AI チャットへの貼り付けに最適化。

スケールを見据えて構築

• マルチロケールビルドによる国際化
• 複数ドキュメントリリースに対応するバージョン管理
• モノレポ・マルチプロジェクト構成向け Workspaces
• コア機能を拡張するプラグインシステム
• 完全なテーマ対応、ビルトインテンプレート、カスタム CSS/JS、ライト/ダークモード

CLI

docmd dev            # ローカル dev サーバー
docmd build          # デプロイ用ビルド
docmd live           # ブラウザベースのライブエディタ
docmd migrate        # Docusaurus / VitePress / MkDocs / Starlight から取り込み
docmd deploy         # Docker / NGINX / Caddy / Vercel / Netlify 用設定を生成
docmd validate       # 内部リンクを全てチェック
docmd mcp            # stdio 上で MCP サーバーとして動作
docmd add <name>     # プラグインまたはテンプレートをインストール

プラグイン

コア機能は堅牢なプラグインシステムによって支えられています。必須機能は標準で含まれており、特定のニーズに応じてオプショナルプラグインを追加できます。

オプショナルプラグインのインストール：

docmd add <plugin-name>

自作：プラグイン開発ガイド

設定

始めるのに設定は不要です。プロジェクトルートに docmd.config.json（または .ts / .js）を追加するのは、より詳細な制御が必要な場合のみです：

{
  "title": "マイプロジェクト",
  "url": "https://docs.myproject.com",
  "src": "./docs",
  "out": "./dist"
}

TypeScript / JavaScript 形式の設定ファイルは動的な値の指定に対応しています。

リファレンス全体：設定概要

プロジェクト構成

my-docs/
├── docs/                ← あなたの Markdown ファイル
├── assets/              ← 画像と静的ファイル
├── docmd.config.json    ← 任意の設定
└── package.json

ライブエディタ

ブラウザベースのエディタでドキュメントを執筆・プレビュー — ローカル環境構築は不要。

live.docmd.io で試す

プログラマティック API

Node.js スクリプト、CI パイプライン、カスタムビルドステップで docmd を利用できます。（CommonJS / ESM の両対応。）

import { build } from '@docmd/core';

await build('./docmd.config.json', { isDev: false });

リファレンス全体：Node API

コミュニティ

• バグ報告・問題 → GitHub Issues
• 質問・アイデア → Discussions
• コントリビューション → CONTRIBUTING.md
• ロードマップ → GitHub Discussions

サポート

• docmd の開発を最も直接的に支援する方法は、周りの人に知らせることです。X で シェア したり、スターを付けるのも良いでしょう。
• docmd があなたの時間を節約できているなら、GitHub Sponsorship は大きな励みになります。
• アイデアやバグがあれば Issue や PR をお気軽に。プラグインのコントリビューションも歓迎します。

ライセンス

MIT — 詳細は LICENSE を参照。