這個外掛並未在最新的 3 個 WordPress 主要版本上進行測試。開發者可能不再對這個外掛進行維護或提供技術支援,並可能會與更新版本的 WordPress 產生使用上的相容性問題。

WP Gatsby Markdown Exporter

描述

The plugin creates zip files containing posts converted to Markdown. A WP-CLI command exists to handle exporting sites with a large amount of content.

  • Move WordPress content to Gatsby-friendly Markdown.
  • Customize the export! Remap and restructure exported fields.
  • CLI: Avoid PHP timeouts by using the command line with WP-CLI.
  • CLI: Export progress bar (great for large sites)!

Reminder: always keep a backup of the WordPress database and files in case your export doesn’t work as expected!

Working with Gatsby

If you’re just getting started with Gatsby, we recommend experimenting with a Markdown based Gatsby starter like Tina Grande. Installation is as easy as:

git clone https://github.com/tinacms/tina-starter-grande.git

cd tina-starter-grande

yarn install && gatsby develop

Then copy your exported WordPress Markdown into the content directory or point the wp gatsby-markdown-export command at the content directory.

Want to port your WordPress or HTML theme to Gatsby? Checkout Porting an HTML Site to Gatsby for tips.

Command Line Usage

The command line functionality uses WP-CLI to interact with WordPress. WP-CLI is easy to install if you haven’t already.

Once it’s installed, you can export content to a directory like this:

wp gatsby-markdown-export --directory=/example/gatsby-starter/src/content

All CLI arguments are optional.

Option
Description
Default value

--help
get help

--directory=
export output directory
random temp directory

--post_types=
post types to export, see: https://developer.wordpress.org/reference/classes/wp_query/#post-type-parameters
page,post

--post_status=
post status to export, see: https://developer.wordpress.org/reference/classes/wp_query/#status-parameters
any

--fields_to_markdown=
fields to convert to Markdown
excerpt

--excluded_front_matter=
fields to exclude from front matter

--post_date_format=
format for post publish date, see: https://www.php.net/manual/en/function.date.php
c

--upload_dir=
directory in the export to copy WordPress uploads
uploads

--remap_fields=
remap front matter field names, example: find1,replace1;find2,replace2

--fields_to_array=
convert single value front matter fields to arrays

--include_private_fields=
private post meta fields to include (they start with _)

--skip_copy_uploads
flag, skips copying WordPress uploads to the export

--skip_original_images
flag, skips the use of original dimension images

--skip_enforce_charset
flag, skips use of blog_charset for the XML charset

--create_type_directory
flag, creates directories based on post type

螢幕截圖

  • The export options form allows for customization of the exported Zip file.

安裝

  1. Upload the plugin files to the /wp-content/plugins/plugin-name directory, or install the plugin through the WordPress plugins screen directly.
  2. Activate the plugin through the ‘Plugins’ screen in WordPress
  3. Use the Settings->Export to Gatsby screen to export content

常見問題

What does `Warning: The markdown converter encountered invalid HTML and could not convert the content at:` mean?

This means that the markdown converter couldn’t convert the referenced post to markdown, so we will just copy the HTML as it is.

評價

2020年4月30日
Just what I needed -- to export all my posts and pages in a readable format! The formatting conversion is beautiful -- straight to markdown! Each page and post is its own file. Just great!
閱讀全部1個評價

貢獻者及開發者

“WP Gatsby Markdown Exporter” 是一個開源的軟體。以下的人對這個外掛作出了貢獻。

貢獻者

將 WP Gatsby Markdown Exporter 外掛本地化為台灣繁體中文版。

對開發相關資訊感興趣?

任何人均可瀏覽程式碼、查看 SVN 存放庫,或透過 RSS 訂閱開發記錄

修改日誌

0.3.3

  • Support including private post meta fields (like Yoast)