Marklane – Fast Publishing from Markdown.

Descripción

Marklane is built for fast publishing from Markdown. It helps editors turn local Markdown drafts into WordPress posts without copying content into the post editor by hand.

Write locally in Markdown, add YAML frontmatter for post settings, then import the file from 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 featuredImage against existing attachments
  • Polylang support: connect translated posts from lang and translations frontmatter
  • CommonMark + GFM conversion: parse Markdown with league/commonmark

For the most predictable image resolution behavior, it is recommended to disable WordPress’s year/month based upload folders and to use fully unique filenames for Markdown files and image assets.

This plugin is best suited to workflows where:

  • 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

Frontmatter quick reference:

Marklane reads YAML frontmatter at the top of the Markdown file. Common keys include:

  • title
  • slug
  • postType
  • excerpt
  • status
  • date
  • category
  • tags
  • featuredImage
  • lang
  • translations

    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

Capturas

  • Import screen with Markdown upload, related image selection, post status options, Dry Run, and import controls.

Instalación

  1. In the WordPress admin screen, go to Plugins > Add New.
  2. Search for Marklane.
  3. Click Install Now, then activate the plugin.
  4. Open Tools > Marklane.
  5. Upload a Markdown file or select one from the Media Library.
  6. Run a dry run to preview the result.
  7. Run the import to create or update the post.

If you prefer manual installation, upload the plugin folder to /wp-content/plugins/ and activate it from the Plugins screen.

FAQ

What can I set with frontmatter?

You can set values such as:

  • title
  • slug
  • postType
  • excerpt
  • status
  • date
  • category
  • tags
  • featuredImage
  • lang
  • translations

    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 featuredImage resolution
  • 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.

Reseñas

No hay reseñas para este plugin.

Colaboradores y desarrolladores

«Marklane – Fast Publishing from Markdown.» es un software de código abierto. Las siguientes personas han colaborado con este plugin.

Colaboradores

Registro de cambios

1.4.8

  • Lower the minimum supported PHP version to 8.0.

1.4.7

  • Improve WordPress.org compliance in the admin screen and upload cleanup flow.

1.4.6

  • Add a dedicated short description for the WordPress.org plugin listing.

1.4.5

  • 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.

1.4.4

  • Strengthen supporting image upload validation.
  • Allow imports into public post types by default.

1.4.3

  • Add text/markdown style MIME detection for Markdown uploads.
  • Change the PHP requirement to 8.1 or later.

1.4.2

  • Optimize admin assets and distribution packaging.

1.4.1

  • 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.

1.4.0

  • Allow setting a featured image from featuredImage frontmatter, 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.

1.3.1

  • Fix Media Library Markdown uploads on WordPress 5.6 and improve import log display.

1.3.0

  • Improve package metadata handling for distribution builds.

1.2.0

  • 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.

1.1.0

  • Change Dry Run from a checkbox option to a dedicated action button.

1.0.2

  • Improve Plugin Check compatibility and initialize translation support.

1.0.1

  • Improve Plugin Check compatibility for WordPress.org submission.

1.0.0

  • Add Markdown import, Dry Run, and Polylang support.

0.1.6

  • Improve relative image and featuredImage resolution.

0.1.5

  • Improve existing post update handling for Markdown attachments.

0.1.4

  • Improve date handling for ISO 8601 values.

0.1.2

  • Simplify frontmatter fields and improve preview behavior.

0.1.1

  • Improve import preview clarity.

0.1.0

  • Initial release