medium

Convert any content source to Medium-ready format. This command is adaptive - it works with any input format and blog structure.

Usage: $ARGUMENTS

Phase 1: Universal Input Detection

Parse Input:

• Extract content input from $ARGUMENTS
• Examples:
  • 2025-10-06-my-post (slug)
  • path/to/article.md (file path)
  • https://myblog.com/post (URL)

Detect and Load Content:

If input looks like a file path (contains / or file extension):

• Use Read tool to load the file
• Detect format by extension:
  • .md / .mdx → Parse markdown with frontmatter
  • .pdf → Inform user PDF parsing is limited, suggest markdown
  • .html → Extract main content, strip HTML tags
  • .txt → Read as plain text
  • .json → Parse and extract relevant fields

If input looks like a URL (starts with http:// or https://):

• Use WebFetch tool to retrieve the page
• Extract main article content, title, and description
• Parse and clean the text

If input is a slug (no / and no protocol):

• Search codebase using Glob: **/*${input}*.md
• Common blog locations:
  • src/content/blog/posts/**/*${input}*.md
  • content/blog/*${input}*.md
  • posts/*${input}*.md
  • blog/*${input}*.md
• Use Read tool to parse found markdown file

Discover Blog Structure (if slug or file path): Explore the codebase to understand:

• 📁 Where are markdown files stored?
• 📋 What frontmatter format is used?
• 🖼️ Where are images/diagrams stored?
• 🎨 How are images referenced? (relative paths, absolute URLs, picture elements?)
• 🔗 What's the blog post URL structure?

For URLs: Extract and use the content as-is, skip blog structure discovery.

Phase 2: Create Conversion Script

Write a custom TypeScript conversion script that handles their specific structure.

Required Outputs (Universal Medium Best Practices):

1. Image Handling - Upload Markers (CRITICAL)

// Medium strips base64 and external URLs fail
// Solution: Add clear upload marker for FIRST image only
// IMPORTANT: Only include the FIRST image from the blog post
return `\n\n---\n\n**📊 [UPLOAD IMAGE HERE: ${altText}]**\n\n*File: \`${relPath}\`*\n\n---\n\n`;