MVP Docs adds a simple documentation system to your WordPress site. It creates a Docs custom post type with categories, a clean archive page, and a markdown import tool \u2014 nothing more.<\/p>\n\n
Why MVP Docs?<\/strong><\/p>\n\n AI tools like Claude and ChatGPT are excellent at generating documentation in Markdown format. MVP Docs was built to take advantage of that \u2014 paste your AI-generated Beyond the AI workflow, most documentation plugins are overbuilt. They add custom page builders, proprietary editors, dozens of database tables, and megabytes of JavaScript. MVP Docs takes the opposite approach:<\/p>\n\n Features<\/strong><\/p>\n\n Markdown Import \u2014 Built for AI-Generated Docs<\/strong><\/p>\n\n AI tools produce clean, well-structured Markdown. MVP Docs lets you import those Use your favorite AI to generate docs, how-to guides, or knowledge base articles in Markdown, then import them into WordPress without any reformatting.<\/p>\n\n Supported: headings, bold, italic, links, images, tables, fenced code blocks with syntax hints, task lists, strikethrough, blockquotes, horizontal rules, ordered and unordered lists.<\/p>\n\n Import \/ Export<\/strong><\/p>\n\n Go to Docs > Settings > Import \/ Export to:<\/p>\n\n Existing docs with the same title are skipped during import to avoid duplicates. Categories are created automatically if they don't exist.<\/p>\n\n WP-CLI<\/strong><\/p>\n\n Every admin action has a command-line equivalent, so a docs site can be stood up and populated entirely from a shell script or AI agent. Run Content<\/em><\/p>\n\n Import a Markdown file as a doc. Output is byte-identical to the sidebar Markdown importer \u2014 same blocks, same title extraction from the first Import a raw HTML file as a doc. Block-commented HTML is preserved as-is; plain HTML renders as a Classic block in the editor.<\/p>\n\n Both import commands accept:\n* Backup and migration<\/em><\/p>\n\n Dump docs, categories, settings, and category order to a single JSON bundle. Omitting both flags exports everything. Pipe to stdout or write to a file.<\/p>\n\n Restore a JSON bundle. Docs are deduplicated by title, so running the same import twice is safe.<\/p>\n\n Structure<\/em><\/p>\n\n Set the display order of categories. Accepts term IDs or slugs.<\/p>\n\n Settings<\/em><\/p>\n\n Show every setting with its current value, description, and allowed form \u2014 self-documenting so you never have to read the source to discover what's configurable.<\/p>\n\n Print a single setting's value.<\/p>\n\n Update one or more settings. Values run through the same sanitizer as the admin UI; if a value is rejected (e.g. Quick start for AI agents<\/em><\/p>\n\n Yes. MVP Docs auto-detects whether you're using a block theme or a classic theme and uses the appropriate template system. The archive styling is minimal and designed to work within your theme's layout.<\/p><\/dd>\n Yes. When editing a doc, open the sidebar and click \"Import from Markdown\" under Doc Settings. Select a Yes. Use the Import \/ Export tab under Docs > Settings to export your docs, categories, and settings as a JSON file, then import it on another site.<\/p><\/dd>\n No. CSS and JS are only loaded on doc pages \u2014 the archive, category pages, search results, and single docs. Nothing is enqueued globally.<\/p><\/dd>\n Yes. Go to Docs > Settings > Permalinks to change the docs slug and category slug.<\/p><\/dd>\n Yes. MVP Docs ships a complete WP-CLI command set \u2014 activate the plugin, configure settings, create categories, and import Markdown or HTML docs all from a shell script. See the \"WP-CLI\" section above and run Your content stays. Docs are standard WordPress posts \u2014 they remain in your database and can be accessed via the admin even without the plugin active.<\/p><\/dd>\n\n<\/dl>\n\n\n.md<\/code> files straight into WordPress with a single click. No copy-pasting HTML, no reformatting, no fussing with blocks. Just import and publish.<\/p>\n\n\n
\n
\/docs\/<\/code><\/li>\n\/docs\/search\/<\/code><\/li>\n.md<\/code> file and it converts to native Gutenberg blocks (tables, code blocks, lists, and all GFM features)<\/li>\nget_header()<\/code>\/get_footer()<\/code><\/li>\n.md<\/code> files directly into the block editor with one click. The sidebar includes an \"Import from Markdown\" button \u2014 upload a file and it gets parsed client-side with full GitHub Flavored Markdown support (via marked.js), then converted into native Gutenberg blocks. The first # Heading<\/code> becomes the post title automatically.<\/p>\n\n\n
wp mvp-docs <command> --help<\/code> for full details on any command below.<\/p>\n\nwp mvp-docs import-md <file>\n<\/code><\/pre>\n\n#<\/code> heading.<\/p>\n\nwp mvp-docs import-raw <file>\n<\/code><\/pre>\n\n--title=<text><\/code> \u2014 override the extracted title\n* --slug=<slug><\/code> \u2014 explicit post slug\n* --excerpt=<text><\/code> \u2014 short description shown on category\/search pages\n* --category=<slug><\/code> \u2014 assign to this category (created if missing)\n* --sort-order=<n><\/code> \u2014 in-category sort priority (lower appears first)\n* --status=<publish|draft|private><\/code> \u2014 post status (default: publish)\n* --dry-run<\/code> \u2014 print the generated markup instead of creating a post<\/p>\n\nwp mvp-docs export [--docs] [--settings] [--output=<file>] [--pretty]\n<\/code><\/pre>\n\nwp mvp-docs import <file>\n<\/code><\/pre>\n\nwp mvp-docs reorder-categories <slug-or-id>...\n<\/code><\/pre>\n\nwp mvp-docs settings list [--format=table|json|yaml|csv]\n<\/code><\/pre>\n\nwp mvp-docs settings get <key>\n<\/code><\/pre>\n\nwp mvp-docs settings set <key=value>...\n<\/code><\/pre>\n\ncolumns=7<\/code> when the allowed range is 1\u20134), a warning names the allowed form and shows the actual saved value. Changing docs_slug<\/code> or category_slug<\/code> auto-flushes rewrite rules.<\/p>\n\nwp plugin activate mvp-docs\nwp mvp-docs settings set docs_slug=kb archive_title=\"Knowledge Base\"\nwp term create mvpd_category \"Getting Started\" --slug=getting-started\nwp mvp-docs reorder-categories getting-started\nwp mvp-docs import-md .\/intro.md --category=getting-started --sort-order=1\nwp mvp-docs export --output=backup.json\n<\/code><\/pre>\n\n\n\n
\n
Does it work with my theme?<\/h3><\/dt>\n
Can I import existing markdown files?<\/h3><\/dt>\n
.md<\/code> file and it will be converted to native Gutenberg blocks.<\/p><\/dd>\nCan I migrate docs between sites?<\/h3><\/dt>\n
Does it add scripts or styles to every page?<\/h3><\/dt>\n
Can I change the URL structure?<\/h3><\/dt>\n
Can I script setup for an AI agent or CI pipeline?<\/h3><\/dt>\n
wp mvp-docs <command> --help<\/code> for detailed options.<\/p><\/dd>\nWhat happens if I deactivate the plugin?<\/h3><\/dt>\n
1.1.0<\/h4>\n\n
\n
wp mvp-docs import-md|import-raw|export|import|reorder-categories|settings<\/code>) \u2014 configure and populate a docs site without touching wp-admin<\/li>\nwp mvp-docs settings list<\/code> now shows description and allowed-value form for every setting; settings set<\/code> warns when a value is rejected and explains what's allowed<\/li>\n.mvpd-page-header<\/code>, .mvpd-page-title<\/code>, .mvpd-page-subtitle<\/code> classes to header shortcode output so themes can't override plugin spacing<\/li>\n--mvpd-card-bg<\/code> for reliable contrast on dark accent colors<\/li>\n:visited<\/code> handling to beat classic themes)<\/li>\n<\/ul>\n\n1.0.7<\/h4>\n\n
\n
1.0.6<\/h4>\n\n
\n
1.0.5<\/h4>\n\n
\n
1.0.4<\/h4>\n\n
\n
1.0.3<\/h4>\n\n
\n
1.0.2<\/h4>\n\n
\n
1.0.1<\/h4>\n\n
\n
1.0.0<\/h4>\n\n
\n