markdown-kit is an ecosystem for writing, linting, validating, and transforming markdown-first content across docs and professional documents.
Why markdown-kit?
- Unified workflows for
.md,.mdx,.mdc, and.mdd - Opinionated quality pipeline (
oxfmt+oxlint+ remark tooling) - Editor-native ergonomics via LSP and VS Code extension
- Seamless output pipeline from markdown content to DOCX
|
|
| Technology | Role |
|---|---|
| Runtime baseline | |
| Type-safe package development | |
| Package management | |
| Markdown/MDX processing pipeline | |
| Editor integration |
| Repository | Package | Purpose |
|---|---|---|
markdownkit |
@markdownkit/markdownkit |
Opinionated markdown formatter/linter CLI |
oxlint-mdx |
@markdownkit/oxlint-mdx |
Oxlint-first MD/MDX linting with source-remapped diagnostics/fixes |
remark-mdd |
@markdownkit/remark-mdd |
Remark plugins + validation primitives for MDD |
mdd |
@markdownkit/mdd |
MDD preview/validation CLI for professional document workflows |
md-docx |
@markdownkit/md-docx |
Markdown ↔ DOCX conversion library + CLI |
| Repository | Package | Purpose |
|---|---|---|
mdk-lsp |
@markdownkit/lsp |
Language Server for markdown + MDD diagnostics/formatting |
mdk-vscode |
mdk-vscode |
VS Code extension powered by Markdownkit + LSP |
|
1. Install npm i -D @markdownkit/markdownkit
|
2. Format Run markdownkit format
|
3. Lint Run markdownkit lint
|
4. Integrate Add LSP / VS Code extension |
npm i -D @markdownkit/markdownkit
npx markdownkit format
npx markdownkit lint| Resource | Link |
|---|---|
| Markdownkit CLI | github.com/markdown-kit/markdownkit |
| oxlint-mdx | github.com/markdown-kit/oxlint-mdx |
| MDD CLI | github.com/markdown-kit/mdd |
| remark-mdd | github.com/markdown-kit/remark-mdd |
| md-docx | github.com/markdown-kit/md-docx |
| VS Code Extension | github.com/markdown-kit/mdk-vscode |
Contributions are welcome across all markdown-kit repositories.
| Type | Action |
|---|---|
| Bug report | Open an issue |
| Feature request | Start a discussion |
| Package contributions | Browse organization repos |
All markdown-kit repositories are released under the MIT License unless noted otherwise in a specific project.