Publish Skill

CLI Usage

Convert a markdown file to a self-contained HTML document:

node {pluginDir}/dist/publish/cli.js \
  --input file.md \
  --output file.html \
  --template default \
  --title "Document Title"

Or pipe markdown via stdin:

echo "# Title\n\nContent" | node {pluginDir}/dist/publish/cli.js --output file.html

Flags

Output

JSON to stdout:

{ "success": true, "outputPath": "/path/to/file.html", "title": "...", "template": "...", "tabbed": true, "sectionCount": 4, "wordCount": 1200 }

Templates

Tab Behavior

Tabs activate automatically when the template defaults to tabs AND the document has 3+ H2 sections. Each H2 heading becomes a tab label. Override with --tabs or --no-tabs.

For print and no-JS contexts, all tab panels display as stacked sections.

Writing Content for Publishing

When generating markdown that will be published:

• Use H2 headings for major sections — they become tabs in report/review templates
• Aim for 3–6 H2 sections for optimal tab layout
• Use tables for comparative or structured data
• Use blockquotes for key takeaways or executive summaries
• Keep paragraphs to 3–4 sentences — shorter reads better in HTML
• Match audience to template — briefing = non-technical, report = data-forward, review = technical

After Conversion

Open the HTML in the default browser:

open file.html