Marklane - Batch Markdown Import for WordPress
| 开发者 | cck23 |
|---|---|
| 更新时间 | 2026年11月7日 11:05 |
| PHP版本: | 8.2 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
meta), and existing custom taxonomies (taxonomies). Marklane does not create new custom field definitions or taxonomy structures.
Update existing posts: Re-import a Markdown file to update its matching WordPress post. Dry Run shows the planned action, taxonomy and image resolution, warnings, and errors before saving.
Keep Markdown as your source: local files chosen or dropped into Marklane are not stored in the Media Library. Use Select from Media Library to upload and retain the original file in WordPress. Supporting images uploaded with Markdown are saved without their folder structure.
Marklane also supports relative images, Polylang language links, and optional Mermaid, callout, and display-math rendering. Plain Markdown without frontmatter can create a draft post.
For setup, examples, and supported frontmatter values, see the Marklane guide.
Best suited for:
- Importing several prepared Markdown articles with a result for each file.
- Keeping WordPress post metadata and taxonomy assignments in frontmatter.
- Updating WordPress posts from locally managed Markdown sources.
安装:
- In the WordPress admin screen, go to
Plugins > Add New. - Search for
Marklane. - Click
Install Now, then activate the plugin. - Open
Tools > Marklane. - Drop one or more local Markdown files into the dropzone or click "Choose files". Use "Select from Media Library" to upload and retain source files in WordPress, or to select existing ones. Locally selected Markdown files are not retained in the Media Library.
- Run a dry run to preview the result.
- Run the import to create or update posts, then review the result for each file.
/wp-content/plugins/ and activate it from the Plugins screen.常见问题:
Can I import several Markdown files at once?
Yes. Select multiple .md files and run Dry Run or Import. Marklane reports the result for each file. The default limit is 50 Markdown files per request, and each file can be up to 5 MiB.
What can I set with frontmatter?
You can set values such as:
titleslugpostTypeexcerptstatusdatecategorytagsmeta(supported custom fields)taxonomies(existing custom taxonomies)featuredImagelangtranslations
postType defaults to post. Public registered post types are allowed by default, except attachments. Site-specific overrides can be applied with the marklane_whitelist filter.
If title is omitted, Marklane uses the first H1 and then the filename. If slug is omitted, Marklane derives it from the filename.
The meta field accepts permitted keys with strings, numbers, booleans, or one-dimensional string arrays. The taxonomies field assigns terms in existing eligible taxonomies. Marklane does not create custom field definitions or new custom taxonomies.
Can it update an existing post?
Yes.
The plugin matches an existing post by slug + post_type, or by slug + post_type + lang when Polylang is in use.
What does Dry Run show?
Dry Run shows the planned action before saving anything, including:
- whether the import will create a new post or update an existing one
- which existing post was matched
- taxonomy assignment results
- relative image and
featuredImageresolution - warnings and errors raised during the import
How are images resolved?
For a Markdown file selected from Media Library, relative image paths first look for Media Library images in that attachment's directory. Local Markdown imports have no saved Markdown attachment: image resolution uses the expected WordPress uploads location and falls back to matching basenames across uploads and the Media Library.
When Markdown and supporting images are uploaded together, the supporting images are stored as flat Media Library files, so nested folder paths are not preserved.
The featuredImage frontmatter field follows the same rule and sets the post thumbnail when the target image is already registered in the Media Library. If FIFU is active, featuredImage can also point to an external URL.
For more predictable results, use fully unique filenames and, if possible, disable WordPress's year/month based upload folders before uploading the Markdown file and related images. This is recommended, not required; basename fallback can still resolve images when year/month folders are enabled.
Can I enable Japanese strong-emphasis compatibility behavior?
Yes. Marklane keeps league/commonmark as the Markdown converter and uses strict CommonMark behavior by default. If your Japanese writing workflow needs text such as **「text」**続き to render as strong text, enable the CJK compatibility pass:
add_filter('marklane_enable_markdown_compatibility_preprocessing', '__return_true');
Advanced sites can replace the matching pattern with the marklane_markdown_compatibility_strong_boundary_pattern filter. For example, use a custom pattern for Japanese quoted text followed by a letter or number.
Can it render Mermaid diagrams?
Yes, optionally.
Enable Mermaid rendering from Tools > Marklane, and Marklane will load the bundled Mermaid renderer only on front-end pages that contain language-mermaid code blocks. The renderer uses the locally bundled official Mermaid ESM runtime and loads diagram chunks on demand. The post content is still stored as a normal fenced code block, so disabling the option simply returns the front end to plain code blocks.
Can it render GitHub alerts or Zenn-style callouts?
Yes, optionally.
Enable Extended Markdown from Tools > Marklane, and Marklane will render common callout syntax such as GitHub / Obsidian / GitLab blockquote alerts. Zenn / Docusaurus / Quarto ::: callouts are normalized during import, then enhanced on the front end. :::details is rendered as a native collapsible details element without JavaScript. External embed syntax such as tweets, cards, or videos is not expanded. Advanced sites can limit enabled normalization profiles with the marklane_extended_markdown_profiles filter.
Can it render math formulas?
Yes, optionally. Enable Math rendering from Tools > Marklane, and Marklane will render display formulas written as $$...$$ only on front-end pages that contain math blocks. Inline math is not expanded. Under the hood, Marklane converts formulas to browser-native MathML with a bundled local renderer.
Can my theme override these styles?
Yes. Your theme can customize callouts, Mermaid diagrams, and math blocks using CSS. Callout colors can also be customized with variables such as --marklane-callout-color-note.
For styling examples and more information, see the Marklane official guide.
Is Marklane free?
Yes. Marklane is completely free, and all features are available without payment. If you find it useful, you can optionally support its development on GitHub Sponsors.
Does it work with Polylang?
Yes.
When Polylang is active, you can use lang and translations in frontmatter to connect translated posts.
更新日志:
- Require WordPress 6.4+ and PHP 8.2+.
- Update the YAML parser to the Symfony 7.4 LTS series.
- Update Mermaid to version 12 with refreshed diagram rendering.
- Import multiple Markdown files and review the results for each file.
- Import custom fields and custom taxonomies from frontmatter.
- Improve callout presentation with clearer visual and accessible type indicators.
- Add Japanese translations for the admin interface and import results.
- Add a dedicated Media Library button; Markdown imported through the dropzone is no longer added to the Media Library.
- Simplify admin settings and import result controls.
- Warn about unsupported
metafields while importing other content.
- Add an action to select another Markdown file after an import.
- Move less frequently used options into advanced settings.
- Load Mermaid on demand to reduce initial page loading. For the complete release history, see the Marklane changelog.