md-business

AI-native business documents, powered by Markdown as the source of truth.

Download desktop app View on GitHub Chrome Extension

What is md-business?

md-business is an open-source framework (MIT) for managing operational business documents — invoices, test specifications, design documents, API specifications, database design documents, estimates, meeting notes — as Markdown files with structured YAML frontmatter and JSON Schema validation.

Instead of locking documents inside Word, Excel, PDF, or proprietary SaaS tools that AI agents cannot safely operate, md-business treats Markdown as the canonical source of truth. Humans review through familiar interfaces (PDF, Google Sheets, Chrome viewer, PWA); AI agents read, edit, validate, and diff directly on the underlying text.

Document schemas

invoice/v1 GA

Japan-compliant qualified invoice (適格請求書) with registration number, tax breakdown, and autofill totals.

spec/v1 GA

Basic design specifications with structured sections for system overview, screens, data flow, and acceptance criteria.

test-spec/v1 GA

Test specifications with case tables, execution status, and round-trip sync between Markdown and Google Sheets.

api-spec v0.4.0+ planned

API endpoint specifications with request / response shapes and example payloads.

db-spec / nosql-db-spec v0.8.0 planned

RDB and NoSQL schema design documents with field-level definitions and relationships.

Viewers and tools

Desktop app Windows / macOS

Standalone desktop viewer and editor (Tauri 2 + SvelteKit). Open the six business-document types in purpose-built viewers, edit Markdown in a live split view, export A4 PDF, and auto-update in place. A built-in MCP server lets an AI client (Claude Code, Claude Desktop, Cursor, Cline, …) read and write the documents in the folder you have open — copy the connection settings from the MCP tab and paste them once.
Download →   Connect an AI assistant →   User guide →

Chrome extension Published

Open a local .md in Chrome, preview it as a rendered business document, and export to A4 PDF.
Install from Chrome Web Store →

Google Workspace Add-on Under review

Edit test specifications and other Markdown business documents as a Google Sheet, then push the result back to a GitHub repository as a single commit — same mental model as git push.

PWA viewer In development

Astro 5 + Lit web components viewer for browser-based preview without installation.

Renderer (Paged.js)

A4 print-quality PDF generation from Markdown source via Paged.js.

Core idea

Markdown source of truth
        ↓
Schema validation (JSON Schema + Ajv)
        ↓
AI agent editing (Claude, GPT, Gemini, ...)
        ↓
Git diff / review / approval
        ↓
PDF / Sheets / Docs / browser / desktop / SaaS integration

Links