Fangtao MD IO provides a focused workflow for moving content between Markdown files and WordPress.<\/p>\n\n
images<\/code> and linked media assets inside media<\/code>.<\/li>\n- Use relative asset references in exported Markdown.<\/li>\n
- Include title, slug, permalink, excerpt, date, post type, status, categories, tags, and featured image Front Matter.<\/li>\n<\/ul>\n\n
ZIP Structure<\/h4>\n\n
Single export:<\/p>\n\n
article.md\nimages\/\n article-image.jpg\nmedia\/\n room-tour.mp4\n catalog.pdf\n<\/code><\/pre>\n\nBulk exports place every item in a separate directory with the same internal structure.<\/p>\n\n
For complete English documentation, see README.md<\/code>.\nFor Simplified Chinese documentation, see docs\/README.zh-CN.md<\/code>.<\/p>\n\nParsedown, Parsedown Extra, and cebe\/markdown are bundled under the MIT License.<\/p>\n\n\n
\n- Upload the
fangtao-md-io<\/code> directory to \/wp-content\/plugins\/<\/code>, or install the plugin ZIP from the WordPress Dashboard.<\/li>\n- Activate the plugin through the Plugins<\/strong> screen.<\/li>\n
- Open the Markdown<\/strong> menu in the WordPress Dashboard.<\/li>\n
- Use Markdown Import<\/strong> or Markdown Export<\/strong>.<\/li>\n<\/ol>\n\n\n
\nWhat are the server requirements?<\/h3><\/dt>\nThe plugin requires WordPress 6.0 or later and PHP 7.4 or later. ZIP import and export fall back to the PclZip library bundled with WordPress when the PHP ZIP extension is unavailable. The PclZip fallback requires PHP zlib. Markdown conversion uses a bundled compatibility layer when native PHP mbstring is unavailable. HTML-to-Markdown export requires the PHP DOM extension.<\/p><\/dd>\n
How should I package local assets?<\/h3><\/dt>\nPlace Markdown and asset files in the same ZIP while preserving their relative paths:<\/p>\n\n
articles\/\n living-room.md\n images\/\n living-room.jpg\n media\/\n room-tour.mp4\n catalog.pdf\n<\/code><\/pre>\n\nReference the assets in Markdown as:<\/p>\n\n
\n[video src=\"media\/room-tour.mp4\"]\n[Download catalog](media\/catalog.pdf)\n<\/code><\/pre>\n\nOnly referenced assets are imported. Administrators can choose the allowed safe image, video, audio, and PDF extensions under Import Settings<\/strong>.<\/p><\/dd>\nWhich Front Matter fields are supported during import?<\/h3><\/dt>\nThe importer supports single-line title<\/code>, slug<\/code>, permalink<\/code>, excerpt<\/code>, date<\/code>, status<\/code>, password<\/code>, categories<\/code>, tags<\/code>, featured_image<\/code>, and featured_image_id<\/code> values. description<\/code>, category<\/code>, tag<\/code>, cover<\/code>, and image<\/code> are accepted aliases. Complex or nested YAML values are not supported.<\/p>\n\nPrivate posts and password-protected posts are separate WordPress visibility modes and cannot be combined.<\/p><\/dd>\n
Are remote images downloaded?<\/h3><\/dt>\nNot by default. Administrators can enable remote image importing under Import Settings<\/strong>. Downloads use WordPress safe HTTP handling and the Media Library pipeline.<\/p><\/dd>\nWhy was an imported image stored locally instead of OSS?<\/h3><\/dt>\nWhen a detected OSS integration is enabled but has incomplete bucket and credential or role settings, the importer uses normal WordPress local media storage to prevent fatal upload failures. Complete the OSS configuration to restore its normal processing.<\/p><\/dd>\n
Does import overwrite existing posts?<\/h3><\/dt>\nNo. Every Markdown document creates a new WordPress content item.<\/p><\/dd>\n\n<\/dl>\n\n\n
1.9.20<\/h4>\n\n\n- Added an optional JPEG XMP compatibility setting for servers without the PHP DOM extension.<\/li>\n<\/ul>\n\n
1.9.19<\/h4>\n\n\n- Added an administrator-only JSON diagnostic export with privacy redaction and richer import failure context.<\/li>\n<\/ul>\n\n
1.9.18<\/h4>\n\n\n- Preserve sanitized HTML tables while Markdown parsers remain in safe mode.<\/li>\n
- Stop and roll back a document import when a referenced image cannot be added to the Media Library.<\/li>\n<\/ul>\n\n
1.9.17<\/h4>\n\n\n- Clear the selected Markdown and ZIP files after a queued batch finishes, preventing accidental duplicate imports while preserving task results and logs.<\/li>\n<\/ul>\n\n
1.9.16<\/h4>\n\n\n- Updated Parsedown Extra to 0.9.0.<\/li>\n
- Removed an unused WordPress core include from ZIP extraction.<\/li>\n
- Switched translatable source strings to English for WordPress.org language packs.<\/li>\n
- Corrected the WordPress.org contributor username.<\/li>\n<\/ul>\n\n
1.9.15<\/h4>\n\n\n- Centered the Current time and Clear action icons in the publication date picker.<\/li>\n<\/ul>\n\n
1.9.14<\/h4>\n\n\n- Fixed the publication date popover position and combined date and time in one precise control.<\/li>\n<\/ul>\n\n
1.9.13<\/h4>\n\n\n- Made the publication date popup open reliably above or below its input, with aligned action icons.<\/li>\n<\/ul>\n\n
1.9.12<\/h4>\n\n\n- Added a compact publication date field with a popup for typing or selecting date and time, plus Current time and Clear controls.<\/li>\n<\/ul>\n\n
1.9.11<\/h4>\n\n\n- Made the Markdown import and export pages use the available WordPress admin content width.<\/li>\n<\/ul>\n\n
1.9.10<\/h4>\n\n\n- Added persistent import statistics and recent import logs.<\/li>\n
- Added a confirmed Advanced action that clears only import statistics and logs.<\/li>\n<\/ul>\n\n
1.9.9<\/h4>\n\n\n- Added a clear selected files button to the Markdown and ZIP upload field.<\/li>\n<\/ul>\n\n
1.9.8<\/h4>\n\n\n- Refined the import donut chart with percentage callouts, a horizontal legend, and segment highlighting on hover or keyboard focus.<\/li>\n<\/ul>\n\n
1.9.7<\/h4>\n\n\n- Replaced the import statistics bar with a live color-coded donut chart and processed total.<\/li>\n<\/ul>\n\n
1.9.6<\/h4>\n\n\n- Restored visible dropdown arrows for plugin select fields in light and dark admin themes.<\/li>\n<\/ul>\n\n
1.9.5<\/h4>\n\n\n- Refined the Markdown import and export interfaces with a shared full-width workspace, clearer form sections, improved controls, and responsive export cards.<\/li>\n<\/ul>\n\n
1.9.4<\/h4>\n\n\n- Reworked the batch import sidebar with a visible import statistics dashboard, color-coded result bar, per-file task progress, and reset control.<\/li>\n<\/ul>\n\n
1.9.3<\/h4>\n\n\n- Kept the import queue visible, expanded the desktop layout, and protected the import form from being compressed on narrower admin screens.<\/li>\n<\/ul>\n\n
1.9.2<\/h4>\n\n\n- Added a sequential browser upload queue for multiple Markdown and ZIP files, with per-file progress, success, skip, and failure feedback.<\/li>\n<\/ul>\n\n
1.9.1<\/h4>\n\n\n- Fixed imported Media Library images being left with an empty attachment title and appearing as unfinished uploads.<\/li>\n
- Use each Markdown file's ZIP modification time when no manual publication date is set.<\/li>\n<\/ul>\n\n
1.9.0<\/h4>\n\n\n- Added optional import date and time controls with second-level precision.<\/li>\n
- Added private visibility and password-protected post controls.<\/li>\n
- Added Front Matter password support.<\/li>\n<\/ul>\n\n
1.8.1<\/h4>\n\n\n- Fixed the Markdown admin menu icon alignment and refreshed its stylesheet version.<\/li>\n<\/ul>\n\n
1.8.0<\/h4>\n\n\n- Added WordPress locale-aware English translations and a translation template.<\/li>\n
- Fixed Markdown menu icon centering in the WordPress admin sidebar.<\/li>\n
- Validate imported image metadata before completion to avoid unfinished Media Library items.<\/li>\n
- Moved GitHub documentation to the
docs\/<\/code> directory and excluded .gitattributes<\/code> from archive exports.<\/li>\n<\/ul>\n\n1.7.0<\/h4>\n\n\n- Added configurable safe ZIP asset formats for images, video, audio, and PDF files.<\/li>\n
- Added local linked-asset and WordPress video\/audio shortcode imports through the Media Library.<\/li>\n
- Added configurable import limits that follow PHP\/WordPress upload limits by default.<\/li>\n
- Added relative
media\/<\/code> packaging for supported local assets during export.<\/li>\n<\/ul>\n\n1.6.1<\/h4>\n\n\n- Hardened ZIP extraction, upload and download size enforcement, import capabilities, and local image export path validation.<\/li>\n
- Updated Parsedown to 1.8.0 to address a reported regular-expression denial-of-service issue.<\/li>\n<\/ul>\n\n
1.6.0<\/h4>\n\n\n- Renamed the plugin, directory, main plugin file, admin page slugs, text domain, and Composer package to Fangtao MD IO (
fangtao-md-io<\/code>).<\/li>\n- Preserved existing
ftmzi_*<\/code> settings and internal identifiers for upgrade compatibility.<\/li>\n<\/ul>\n\n1.5.1<\/h4>\n\n\n- Added case-insensitive support for additional Markdown text file extensions in direct uploads, ZIP imports, and exports.<\/li>\n<\/ul>\n\n
1.5.0<\/h4>\n\n\n- Added five selectable Markdown parsers: Parsedown, Parsedown Extra, Cebe Markdown, Cebe Markdown GitHub, and Cebe Markdown Extra.<\/li>\n
- Added Traditional, GitHub, and Extra syntax flavor labels.<\/li>\n
- Added a persistent default parser and a per-import parser override.<\/li>\n
- Bundled the parser dependencies for portable installation.<\/li>\n<\/ul>\n\n
1.4.0<\/h4>\n\n\n- Added extended Front Matter import and export metadata.<\/li>\n
- Added optional safe remote image importing.<\/li>\n
- Added filtered mass export and selectable Markdown file extensions.<\/li>\n<\/ul>\n\n
1.3.0<\/h4>\n\n\n- Added an optional category selector when importing standard posts.<\/li>\n
- Added a persistent Draft or Publish immediately default for the import form.<\/li>\n<\/ul>\n\n
1.2.0<\/h4>\n\n\n- Added a WordPress PclZip fallback for individual and bulk Markdown ZIP exports.<\/li>\n
- Preserved the existing
article.md<\/code> and relative images\/<\/code> package structure without requiring PHP ZIP.<\/li>\n<\/ul>\n\n1.1.3<\/h4>\n\n\n- Added a bundled mbstring compatibility layer for Markdown conversion on servers without the PHP mbstring extension.<\/li>\n<\/ul>\n\n
1.1.2<\/h4>\n\n\n- Added a WordPress PclZip fallback for ZIP imports when the PHP ZIP extension is unavailable.<\/li>\n
- Kept archive path, entry count, and extracted-size checks on the fallback path.<\/li>\n<\/ul>\n\n
1.1.1<\/h4>\n\n\n- Prevented incomplete OSS configuration from causing fatal errors during image import.<\/li>\n
- Added readable handling for media import exceptions.<\/li>\n<\/ul>\n\n
1.1.0<\/h4>\n\n\n- Added individual and bulk Markdown ZIP export.<\/li>\n
- Added HTML-to-Markdown conversion and relative image packaging.<\/li>\n
- Added exported Front Matter data.<\/li>\n<\/ul>\n\n
1.0.0<\/h4>\n\n\n- Initial Markdown and ZIP import release.<\/li>\n
- Added local image import and featured image handling.<\/li>\n<\/ul>","raw_excerpt":"Import Markdown and ZIP archives with local media assets, then export WordPress content as portable Markdown ZIP packages.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/351770","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=351770"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/fxy5750"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=351770"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=351770"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=351770"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=351770"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=351770"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=351770"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}