Minerald is a WordPress plugin that turns any Git-managed Markdown content
into a commit-driven, version-controlled WordPress publishing workflow.
Write in Obsidian. Commit to Git. Auto Published to WordPress.
Minerald works directly with Obsidian — and any other Markdown-based workflow.
There is no separate publish step.
If your content lives as Markdown in Git, Minerald treats every commit as
publishing intent and automatically publishes it to WordPress.
Write Markdown anywhere.
Generate content with humans or AI.
Commit it to Git.
Minerald publishes it — automatically.
Features
Markdown-first, tool-agnostic
- Convert Markdown files into WordPress posts or pages
- Works with content written by humans, scripts, or AI systems
- Compatible with Obsidian, static site generators, LLM pipelines, or custom tools
- Preserves headings, lists, code blocks, tables, and basic formatting
Optional front matter support
- YAML front matter can be used to control:
- post type
- post status
- categories and tags
- slug and publish date
- custom fields
- Front matter is optional — plain Markdown works without configuration
Git as the source of truth
- Pull content from any Git repository (GitHub, GitLab, or self-hosted)
- Read-only deploy key support
- Supports branches, tags, or pinned commits
- Git history serves as a full audit log
Incremental and deterministic sync
- Each Markdown file maps to a single WordPress object
- Create, update, or delete content based on Git diffs
- Re-running sync produces consistent results
- No duplicate posts, no blind re-imports
Folder-to-structure mapping
- Map folders to:
- post types
- categories
- page hierarchies
- Designed to scale to repositories with hundreds or thousands of files
- Suitable for documentation sites, knowledge bases, or generated content trees
Background processing
- Uses WordPress Action Scheduler for background jobs
- Large repositories are split into small, retryable tasks
- Avoids timeouts and blocking admin requests
Safe by design
- Uses standard WordPress APIs only
- No direct database writes
- Read-only Git access
- All changes are traceable to Git commits
Typical Use Cases
- Publish Markdown documentation maintained in Git
- Turn AI-generated Markdown into WordPress posts
- Use WordPress as a frontend for generated or static content
- Build a CI/CD-style content publishing pipeline
- Maintain long-term content archives with full version history
How It Works
- Markdown files are written or generated by any tool
- Content is committed to a Git repository
- Minerald pulls changes manually or on schedule
- Markdown files are transformed into WordPress content
- WordPress reflects the current state of the repository
Git is the source of truth.
WordPress is the presentation layer.
Who This Plugin Is For
- Developers who prefer Git-driven workflows
- Teams using AI systems to generate Markdown content
- Site owners who value content ownership and reproducibility
- Anyone who wants to publish to WordPress without editor lock-in
Who This Plugin Is Not For
- Real-time collaborative editors
- WYSIWYG-only workflows
- Users who want WordPress to be the primary authoring environment
Short Description
Publish Markdown from Git to WordPress.
Tool-agnostic, version-controlled, automation-friendly.
License
GPLv2 or later