blogging

You can manage Markdown blog posts via a CLI by searching, creating, editing, and listing entries located in your local posts directory. The CLI reads and preserves YAML frontmatter while parsing dates and slugs directly from filenames to maintain structure.

Preserving YAML frontmatter during Markdown edits is handled by parsing the metadata block separately from the body content. The CLI reads the existing frontmatter, applies edits only to the post content, and reassembles the file without losing metadata.

Converting a single-file Markdown post to a folder-based index structure is supported directly by the CLI. This process transforms a standalone file into a directory containing an index file, allowing you to organize assets alongside the post content.

Creating a new Markdown blog post with a custom slug and optional title is fully supported. The CLI generates the file in the designated posts directory, using the provided slug for the filename and embedding the title in the YAML frontmatter if specified.

The best way to search Markdown posts by slug, title, or content is using the built-in CLI search functionality. It scans the local posts directory and matches queries against filenames, frontmatter titles, and the body text of the Markdown files.

You need a specific directory structure to manage Markdown posts, as the CLI targets the ~/Repositories/www/posts location. Both single-file posts and folder-based posts are supported within this directory, enabling flexible content organization.