From WordPress to Tiki-Flavored Markdown
This page describes the process to migrate content from WordPress into Tiki and then convert the imported content to Tiki-Flavored Markdown.
1. Export content from WordPress
Export a WordPress XML / WXR file from the WordPress admin interface.
In WordPress:
- Go to Tools > Export
- Choose the content to export
- Download the XML file
2. Import the WordPress XML file into Tiki
Use the Tiki WordPress importer.
See:
https://doc.tiki.org/WordPress-importer
Recommended first test:
- Import without attachments
- Confirm pages and posts are created
- Then retry with attachments enabled
Known things to check:
- Long site titles used as file gallery names
- Large attachment imports
- Failed remote attachment downloads
3. Review imported content
After import, review:
- wiki pages
- blog posts
- categories
- images and attachments
- internal links
- WordPress shortcodes
- HTML blocks
- hidden comments
- tables and lists
4. Convert imported Tiki syntax to Markdown
Once the content is imported into Tiki, convert the wiki pages from Tiki syntax to Markdown.
See:
https://doc.tiki.org/Converting-from-Tiki-syntax-to-Markdown
From the command line, conversion can be tested with:
php console.php markdown:convert --markdown --page="Page name"
To save the converted page:
php console.php markdown:convert --markdown --save --page="Page name"
Important: use --save only after reviewing the output, because it overwrites the page content.
5. Check conversion quality
After conversion, check especially:
- external links
- internal links
- images
- file attachments
- headings
- tables
- HTML blocks
- plugins
- WordPress shortcodes
- hidden comments such as ~hc~
Some content may need manual cleanup after automatic conversion.
6. Repeat on a small sample before the full site
Recommended workflow:
- Import a small WordPress export first
- Convert a few pages manually or with dry-run command
- Review the output
- Fix blockers
- Then repeat with the full site export
Related documentation