Publish from code.
Automate your workflow.

# Run without a global installation
npx zyvop --help

# Publish and cross-post an article
npx zyvop publish ./my-article.md

# Recommended for publishing and CI/CD
zyvop login --token zv_0123456789abcdef0123456789abcdef0123456789abcdef

# Or provide the developer token through the environment
export ZYVOP_TOKEN="zv_0123456789abcdef0123456789abcdef0123456789abcdef"

# Interactive user-session login (required by import)
zyvop login

# Inspect the stored authentication and endpoint
zyvop whoami

# Clear stored credentials on this machine
zyvop logout

# Local dry-run preview: validates markdown without contacting servers or publishing
zyvop publish ./my-article.md --dry-run --base-url https://myblog.com/

# Publish article live and cross-post to all enabled syndication targets
zyvop publish ./my-article.md

# Publish as a private draft with custom overrides
zyvop publish ./my-article.md --draft --tags "nextjs,react,typescript"

---
title: Building Scalable Microservices with Go
subtitle: A practical deep-dive into distributed architecture
tags: [golang, backend, docker, microservices]
canonical_url: https://myblog.com/go-microservices
base_url: https://myblog.com/
category: backend
cover_image: /images/go-architecture.webp
generate_toc: true
cross_post:
  devto: true
  hashnode: true
  medium: true
  bluesky: true
  wordpress: true
---

# 1. Introduction

Write your technical article here in Markdown with full support for tables, code snippets, and diagrams...

# Import all published articles from Dev.to
zyvop import devto your_devto_username

# Import all articles from Hashnode
zyvop import hashnode yourblog.hashnode.dev

# Import a Medium publication
zyvop import medium @your_medium_username

# Import a public RSS feed
zyvop import rss https://example.com/feed.xml

# Verify current authentication session
zyvop whoami

name: Publish to ZyVOP

on:
  push:
    branches: [main]
    paths:
      - 'posts/**/*.md'

permissions:
  contents: read

concurrency:
  group: zyvop-publish-${{ github.ref }}
  cancel-in-progress: false

jobs:
  publish:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout repository
        uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: 20

      - name: Publish Modified Markdown Posts via ZyVOP CLI
        env:
          ZYVOP_TOKEN: ${{ secrets.ZYVOP_TOKEN }}
        run: |
          set -euo pipefail

          before="${{ github.event.before }}"
          after="${{ github.sha }}"

          if [[ "$before" =~ ^0+$ ]] || ! git cat-file -e "$before^{commit}" 2>/dev/null; then
            mapfile -d '' files < <(git ls-files -z -- ':(glob)posts/**/*.md')
          else
            mapfile -d '' files < <(
              git diff --name-only -z --diff-filter=ACMR                 "$before" "$after" -- ':(glob)posts/**/*.md'
            )
          fi

          if (( ${#files[@]} == 0 )); then
            echo "No Markdown files modified."
            exit 0
          fi

          for file in "${files[@]}"; do
            if [ -f "$file" ]; then
              echo "Deploying $file..."
              npx --yes zyvop@1 publish "$file"
            fi
          done