Marklane - Fast Publishing from Markdown.
| 开发者 | cck23 |
|---|---|
| 更新时间 | 2026年5月9日 23:02 |
| PHP版本: | 8.0 及以上 |
| WordPress版本: | 6.9 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
Tools > Marklane. Marklane can create a new post or update an existing one by slug, apply categories, tags, dates, featured images, post status, and Polylang language links in one import. When frontmatter is omitted, it can derive a draft title and slug from the first H1 and filename.
If you enable Ignore invalid frontmatter, the plugin ignores only the invalid frontmatter keys and keeps the valid ones. If the YAML block itself is broken, it falls back to the filename and first H1 while keeping the selected post status and date options.
Plugin page: https://happas.jp/marklane/
Features:
- Fast Markdown publishing: import prepared Markdown files from the WordPress admin
- YAML-controlled post settings: set title, slug, status, date, categories, tags, featured image, and language links
- Safe re-imports: update existing posts by slug instead of creating duplicates
- Dry Run preview: review the planned create/update action, category and tag assignment, image resolution, warnings, and errors before saving
- Media Library image resolution: resolve relative Markdown image paths and
featuredImageagainst existing attachments - Polylang support: connect translated posts from
langandtranslationsfrontmatter - CommonMark + GFM conversion: parse Markdown with
league/commonmark
- articles are written locally in Markdown
- WordPress is used as the publishing destination
- editors want to keep the import source file manageable inside WordPress
- repeated imports and post updates are part of the workflow
titleslugpostTypeexcerptstatusdatecategorytagsfeaturedImagelangtranslations
title falls back to the first H1 and then the filename. slug falls back to the filename. postType defaults to post, and status defaults to draft.
For more frontmatter examples:
https://happas.jp/en/marklane/#yaml-frontmatter-example
Known limitations:
- Does not create custom post types or taxonomy definitions
- Does not import ZIP archives
- Does not import through REST API or WP-CLI
- Does not download external image URLs automatically
安装:
- In the WordPress admin screen, go to
Plugins > Add New. - Search for
Marklane. - Click
Install Now, then activate the plugin. - Open
Tools > Marklane. - Upload a Markdown file or select one from the Media Library.
- Run a dry run to preview the result.
- Run the import to create or update the post.
/wp-content/plugins/ and activate it from the Plugins screen.常见问题:
What can I set with frontmatter?
You can set values such as:
titleslugpostTypeexcerptstatusdatecategorytagsfeaturedImagelangtranslations
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.
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?
Relative image paths are resolved against Media Library images in the same directory as the selected Markdown attachment.
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.
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.
Does it work with Polylang?
Yes.
When Polylang is active, you can use lang and translations in frontmatter to connect translated posts.
更新日志:
- Lower the minimum supported PHP version to 8.0.
- Improve WordPress.org compliance in the admin screen and upload cleanup flow.
- Add a dedicated short description for the WordPress.org plugin listing.
- Add in-admin links to the official page, YAML frontmatter examples, and reviews.
- Clean up temporary upload cache folders more reliably after imports.
- Improve Pro integration by reserving custom taxonomy mappings for Marklane Pro.
- Strengthen supporting image upload validation.
- Allow imports into public post types by default.
- Add
text/markdownstyle MIME detection for Markdown uploads. - Change the PHP requirement to 8.1 or later.
- Optimize admin assets and distribution packaging.
- Improve existing-post lookup when Polylang is active.
- Show update lookup debug details in import results.
- Allow selecting Markdown and supporting images together from Media Library.
- Allow setting a featured image from
featuredImagefrontmatter, including external URLs when FIFU is active. - Allow importing Markdown even when YAML frontmatter is invalid.
- Allow uploading Markdown files together with supporting images.
- Improve admin result display and import stability.
- Fix Media Library Markdown uploads on WordPress 5.6 and improve import log display.
- Improve package metadata handling for distribution builds.
- Allow importing Markdown files without YAML frontmatter by deriving defaults from the filename and first H1.
- Reuse matching Markdown attachments by content hash instead of updating existing files in place.
- Change Dry Run from a checkbox option to a dedicated action button.
- Improve Plugin Check compatibility and initialize translation support.
- Improve Plugin Check compatibility for WordPress.org submission.
- Add Markdown import, Dry Run, and Polylang support.
- Improve relative image and
featuredImageresolution.
- Improve existing post update handling for Markdown attachments.
- Improve
datehandling for ISO 8601 values.
- Simplify frontmatter fields and improve preview behavior.
- Improve import preview clarity.
- Initial release