Docspress Demo Docs

Docspress turns a nested Markdown docs tree into WordPress Pages while keeping Git as the source of truth.

This demo is configured for fkadev.blog and syncs to WordPress Pages.

What the action does

• Finds Markdown files under docs/.
• Optionally follows docs/docspress.manifest.json for stable page order, titles, slugs, and parents.
• Converts Markdown into Gutenberg block comments and HTML.
• Rewrites local Markdown links to the generated WordPress page URLs.
• Creates a matching WordPress Page hierarchy.
• Updates only pages that were previously generated by Docspress.
• Creates managed moved-page placeholders from docs/redirects.json.
• Reports unmanaged WordPress page collisions as conflicts.

Current sync mode

The workflow currently uses:

status: draft
create-h1: false
manifest-file: docs/docspress.manifest.json
redirects-file: docs/redirects.json
rewrite-links: true
edit-link: true
dry-run: false

Push-triggered runs update draft pages. Manual runs can choose draft or publish, and can turn generated title H1 blocks on or off. Markdown-backed pages include an "Improve this page on GitHub" link.

Demo pages

• Getting Started
• Docs Structure
• Markdown Features
• Gutenberg Importer Tricks
• Action Inputs

Moved-page examples

The redirect map keeps these old paths alive as managed moved-page placeholders:

• guides/old-markdown-features -> Markdown Features
• reference/old-action-options -> Action Inputs
• legacy/gutenberg-importer-tricks -> Gutenberg Importer Tricks

Improve this page on GitHub