Examples

import

Import content from other static site generators or platforms into hwaro. This is the reverse of hwaro tool export.

# Import a WordPress WXR file
hwaro tool import wordpress path/to/export.xml

# Import a Jekyll site directory
hwaro tool import jekyll path/to/jekyll-site

# Import a Hugo site
hwaro tool import hugo path/to/hugo-site

# Import a Notion export
hwaro tool import notion path/to/notion-export

# Import an Obsidian vault
hwaro tool import obsidian path/to/vault

# Specify output directory and include drafts
hwaro tool import jekyll path/to/site -o content/blog --drafts

# Verbose output
hwaro tool import hugo path/to/site --verbose

Supported Sources

Source	Input	Notes
wordpress	WXR XML file	Imports posts and pages from a WordPress export file
jekyll	Site directory	Reads `_posts/` and (with `--drafts`) `_drafts/`
hugo	Site directory	Reads `content/` preserving section layout
notion	Export directory	Recursively imports `.md` files from a Notion export
obsidian	Vault directory	Recursively imports notes (skips dot-prefixed folders)
hexo	Site directory	Reads `source/_posts/` and `source/_drafts/`
astro	Site directory	Reads `src/content/` collections
eleventy	Site directory	Reads Markdown files with Eleventy front matter

Options

Flag	Description
-o, --output DIR	Output content directory (default: `content`)
-d, --drafts	Include draft content
-v, --verbose	Show detailed output
-h, --help	Show help

Behavior

Front matter is converted to hwaro's default TOML format (+++). Hwaro also supports YAML front matter (---); switch the default with [content.new].front_matter_format = "yaml" in config.toml or run hwaro tool convert to-yaml afterwards.
HTML content (e.g. WordPress) is converted to Markdown.
Existing files at the destination path are skipped, not overwritten. Remove or rename them first if you want to re-import.
Only known post types are imported (e.g. WordPress post and page).

Example Output

hwaro: import jekyll
source: ./old-blog
output: content
imported: 42 files, 3 skipped

An errors count is appended only when errors occurred, and a warning reminds you about --force when files were skipped. In a color terminal the same report renders as an ● import heading with aligned rows and an ▴ imported outcome line.

See Also

hwaro tool export — Export hwaro content to other formats
Writing Pages — Front matter reference