Marklane - Publish Markdown without the post editor.
| 开发者 | cck23 |
|---|---|
| 更新时间 | 2026年8月4日 22:33 |
| PHP版本: | 8.0 及以上 |
| WordPress版本: | 7.0 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
- One-workflow post setup: set the title, slug, status, date, categories, tags, featured image, and language links from Markdown frontmatter
- Dry Run preview: review the planned create/update action, taxonomy assignment, image resolution, warnings, and errors before saving
- Publish or update without the post editor: create a new post or update an existing post by slug
- Media Library image resolution: resolve relative Markdown image paths and
featuredImageagainst existing attachments - Polylang support: connect translated posts from
langandtranslationsfrontmatter - Markdown-first publishing: import prepared Markdown files from the WordPress admin
- Mermaid rendering: turn
```mermaidcode blocks into front-end diagrams when enabled - Extended Markdown: render common callout syntax such as GitHub alerts and Zenn messages when enabled
- Math rendering: render
$$...$$display formulas when enabled - Light front-end loading: Mermaid and math assets load only on pages that contain matching content
- 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 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 keys and examples, see the frontmatter guide.
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.
Can it render Mermaid diagrams?
Yes, optionally.
Enable Mermaid rendering from Tools > Marklane, and Marklane will load the diagram renderer only on front-end pages that contain language-mermaid code blocks. 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. Advanced sites can replace the script URL with the marklane_mermaid_script_src filter.
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. Extended Markdown callouts, Mermaid rendering, and Math rendering use ordinary HTML and CSS classes, so themes can override them with their own CSS. Marklane outputs classes such as marklane-callout, marklane-rendered-block, marklane-mermaid, marklane-math, and marklane-math-display. Each callout type exposes one color variable, such as --marklane-callout-color-note or --marklane-callout-color-warning; Marklane derives its background and border colors with color-mix().
Does it work with Polylang?
Yes.
When Polylang is active, you can use lang and translations in frontmatter to connect translated posts.
更新日志:
- Improve existing-post matching and restoration during re-imports.
- Strengthen validation when resolving supplementary images and media.
- Improve script loading reliability.
- Improve Mermaid and math rendering reliability.
- Strengthen permission checks during imports.
- Strengthen relative media path validation.
- Load Extended Markdown assets only on pages that contain callouts.
- Fix callout detection so markers outside blockquotes do not trigger unnecessary assets. For the complete release history, see the Marklane changelog.