Troubleshooting & FAQ

External platforms require publicly accessible absolute URLs (https://...). If your markdown contains ./assets/img.png, pass --base-url when publishing:

zyvop publish post.md --base-url "https://myblog.dev/posts/distributed-systems"

Alternatively, ensure your frontmatter defines canonical_url: "https://myblog.dev/posts/distributed-systems", which ZyVOP uses to automatically infer the base URL origin.

DEV.to's Liquid template parser crashes if an article series title contains round parentheses ( or ). ZyVOP automatically replaces () with square brackets [] in series titles. If you manually embed raw Liquid tags (e.g. {% ... %}), escape them or wrap them in code blocks.

The official Medium REST API does not support editing published posts. When you run zyvop publish on an existing post, ZyVOP updates your DEV.to, Hashnode, and WordPress copies, but logs a notice that Medium must be edited manually in the Medium web editor.

Hashnode requires every post to belong to a publication, and its personal access tokens/read-write GraphQL publishing currently require Hashnode Pro. Log in to Hashnode, confirm that the target publication has an active Pro subscription, and generate a Personal Access Token with read/write access.

Public Hashnode imports depend on API, sitemap, page, or RSS access. Hashnode or Cloudflare may block those requests, while RSS may contain only part of the publication.

For the most reliable complete import:

1. As a Hashnode Pro publication owner or admin, open Publication Dashboard → GitHub.
2. Click Connect and install the Hashnode GitHub Backup app.
3. Choose a repository, creating an empty one first if needed.
4. Run Backup all posts and optionally Backup all drafts.
5. Check Deliveries to confirm that each backup succeeded.
6. Download the GitHub repository as a ZIP and upload it through ZyVOP Dashboard → Posts → Import Articles → Hashnode Backup.

GitHub Backup is a Hashnode Pro feature. Free publications can try individual known article URLs when accessible but do not currently receive this bulk export. Cancelling Pro stops future backups without deleting files already stored in the repository.

Ensure you are using an App Password created in Bluesky Settings → App Passwords, NOT your primary master password. Your identifier should be your complete handle including .bsky.social (e.g. alice.bsky.social).

The ZyVOP Developer API limits requests to 10 requests per minute per developer token. In CI/CD pipelines publishing batch posts, add a 6-second sleep between requests or implement exponential backoff checking the Retry-After response header.