emberflow
/ember-publish-space

/ember-publish-space

Publish a directory of markdown files as a multi-page docs site (a "Space").

/ember-publish-space docs/ as "API Reference"

Features

Spaces include:

  • Sidebar navigation with pages and collapsible sections
  • SPA navigation — switch pages without full reloads
  • Owner editing — drag-and-drop reorder, add/remove pages and sections
  • Shared URL — one link for the whole docs site
  • Mixed content types — markdown, JSON explorer, and explainers in one Space

How It Works

The skill scans a directory for markdown files, creates a document for each one, then groups them into a Space with automatic navigation.

File Structure

The directory structure maps to the navigation:

docs/
├── overview.md          → "Overview" page
├── api-reference.md     → "API Reference" page
└── guides/
    ├── getting-started.md → "Getting Started" (under "Guides" section)
    └── deployment.md      → "Deployment" (under "Guides" section)

Subdirectories become collapsible sections in the sidebar. File names are converted to page titles.

Examples

/ember-publish-space docs/ as "API Reference"
/ember-publish-space src/docs/ as "Internal Docs"

Appearance

Font family
Choose a reading font
Font size
Adjust reading size
100%