| 开发者 | cartpauj |
|---|---|
| 更新时间 | 2026年4月17日 00:14 |
| PHP版本: | 8.0 及以上 |
| WordPress版本: | 6.9 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
.md files straight into WordPress with a single click. No copy-pasting HTML, no reformatting, no fussing with blocks. Just import and publish.
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:
/docs//docs/search/.md file and it converts to native Gutenberg blocks (tables, code blocks, lists, and all GFM features)get_header()/get_footer().md files directly into the block editor with one click. The sidebar includes an "Import from Markdown" button — 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 becomes the post title automatically.
Use your favorite AI to generate docs, how-to guides, or knowledge base articles in Markdown, then import them into WordPress without any reformatting.
Supported: headings, bold, italic, links, images, tables, fenced code blocks with syntax hints, task lists, strikethrough, blockquotes, horizontal rules, ordered and unordered lists.
Import / Export
Go to Docs > Settings > Import / Export to:
wp mvp-docs <command> --help for full details on any command below.
Content
wp mvp-docs import-md <file>
Import a Markdown file as a doc. Output is byte-identical to the sidebar Markdown importer — same blocks, same title extraction from the first # heading.
wp mvp-docs import-raw <file>
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.
Both import commands accept:
--title=<text> — override the extracted title--slug=<slug> — explicit post slug--excerpt=<text> — short description shown on category/search pages--category=<slug> — assign to this category (created if missing)--sort-order=<n> — in-category sort priority (lower appears first)--status=<publish|draft|private> — post status (default: publish)--dry-run — print the generated markup instead of creating a post
Backup and migrationwp mvp-docs export [--docs] [--settings] [--output=<file>] [--pretty]
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.
wp mvp-docs import <file>
Restore a JSON bundle. Docs are deduplicated by title, so running the same import twice is safe.
Structure
wp mvp-docs reorder-categories <slug-or-id>...
Set the display order of categories. Accepts term IDs or slugs.
Settings
wp mvp-docs settings list [--format=table|json|yaml|csv]
Show every setting with its current value, description, and allowed form — self-documenting so you never have to read the source to discover what's configurable.
wp mvp-docs settings get <key>
Print a single setting's value.
wp mvp-docs settings set <key=value>...
Update one or more settings. Values run through the same sanitizer as the admin UI; if a value is rejected (e.g. columns=7 when the allowed range is 1–4), a warning names the allowed form and shows the actual saved value. Changing docs_slug or category_slug auto-flushes rewrite rules.
Quick start for AI agents
wp plugin activate mvp-docs
wp mvp-docs settings set docs_slug=kb archive_title="Knowledge Base"
wp term create mvpd_category "Getting Started" --slug=getting-started
wp mvp-docs reorder-categories getting-started
wp mvp-docs import-md ./intro.md --category=getting-started --sort-order=1
wp mvp-docs export --output=backup.json
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.
Yes. When editing a doc, open the sidebar and click "Import from Markdown" under Doc Settings. Select a .md file and it will be converted to native Gutenberg blocks.
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.
No. CSS and JS are only loaded on doc pages — the archive, category pages, search results, and single docs. Nothing is enqueued globally.
Yes. Go to Docs > Settings > Permalinks to change the docs slug and category slug.
Yes. MVP Docs ships a complete WP-CLI command set — 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 wp mvp-docs <command> --help for detailed options.
Your content stays. Docs are standard WordPress posts — they remain in your database and can be accessed via the admin even without the plugin active.
wp mvp-docs import-md|import-raw|export|import|reorder-categories|settings) — configure and populate a docs site without touching wp-adminwp mvp-docs settings list now shows description and allowed-value form for every setting; settings set warns when a value is rejected and explains what's allowed.mvpd-page-header, .mvpd-page-title, .mvpd-page-subtitle classes to header shortcode output so themes can't override plugin spacing--mvpd-card-bg for reliable contrast on dark accent colors:visited handling to beat classic themes)