n8n Workflow: Sync GitHub Markdown to StudioCMS Pages & Taxonomy

Sync GitHub Markdown to StudioCMS with taxonomy-aware automation

This n8n workflow manually deploys a directory of Markdown/MDX files from GitHub into StudioCMS, automatically parsing frontmatter, creating missing folders/categories/tags, and then creating or updating pages based on slug matching—optionally drafting anything missing.

What this workflow does

• Manual deployment trigger: starts when you trigger a deployment in n8n.
• Find source files in GitHub: lists files from your configured GitHub repository directory and continues only when Markdown/MDX files are present.
• Parse frontmatter for page fields: downloads each Markdown/MDX file, decodes it, and parses YAML-style frontmatter to derive fields such as title, slug, folder, categories, tags, and draft status.
• Validate and detect issues: validates the collection (including duplicate slug detection) and loads current StudioCMS folders, categories, tags, and existing pages.
• Create missing taxonomy: creates any missing StudioCMS folders, categories, and tags required by valid Markdown documents, then refreshes the taxonomy lists.
• Apply page changes by slug: compares each document to existing StudioCMS pages by slug to plan and apply creates, updates, or skips.
• Optional draft behavior: when configured, missing managed pages can be marked as drafts.
• Deployment report: outputs a summary of created, updated, drafted, skipped, and errored items.

Use cases

• Keep StudioCMS content in sync with a GitHub-based documentation or site content repo (Markdown/MDX + frontmatter).
• Automatically maintain taxonomy (folders, categories, tags) as your documentation grows.
• Update live StudioCMS pages safely using slug-based comparisons, with optional draft handling for removed content.

Technical details

• GitHub integration: uses GitHub nodes to list repository directory files and fetch each Markdown/MDX file.
• StudioCMS integration: uses StudioCMS API credentials in nodes that read/write folders, categories, tags, and pages.
• Workflow building blocks: set, code, no op, github, switch, and sticky note.

Ideal for n8n users, automation engineers, and SaaS operators who want reliable GitHub → StudioCMS content sync with taxonomy awareness and slug-based page management.