WordPress.com
Additional Dependencies
This importer requires the following additional libraries.
You may install the needed gems individually by running gem install GEM_NAME or install all of them
with a single invocation:gem install nokogiri open_uri_redirections safe_yaml
Invocation
Sample snippet to invoke the importer:
jekyll-import wordpressdotcom --source FILE --no-fetch-images --assets_folder FOLDER
| Option <PARAM> | Description | ||
|---|---|---|---|
--source FILE |
WordPress export XML file |
Default: 'wordpress.xml' |
|
--no-fetch-images |
Do not fetch the images referenced in the posts |
Default: false |
|
--assets_folder FOLDER |
Folder where assets such as images will be downloaded to |
Default: 'assets' |
|
The source, no_fetch_images, and assets_folder fields are not required.
Their default values are what you see above.
ProTip™: WordPress.com Export Tool
If you are migrating from a WordPress.com account, you can
access the export tool at the following URL:
https://YOUR-USER-NAME.wordpress.com/wp-admin/export.php.
Further WordPress migration alternatives
While the above method works, it doesn’t import absolutely every piece of metadata. If you need to import custom fields from your pages and posts, the following resources might be useful to you:
- Exitwp is a configurable tool written in Python for migrating one or more WordPress blogs into Jekyll (Markdown) format while keeping as much metadata as possible. Exitwp also downloads attachments and pages.
- A great article with a step-by-step guide for migrating a WordPress blog to Jekyll while keeping most of the structure and metadata.
- wpXml2Jekyll is an executable windows application for creating Markdown posts from your WordPress XML file.