@@ -8,6 +8,10 @@ on:
             - "**.js"
             - "**.json"
             - "**.xml"
+            # test fixtures only: these feed the golden builds. docs markdown does not.
+            - "tests/**.md"
+            - "tests/**.dox"
+            - "tests/**.toml"
             - "**/poxy/data/*"
             - "**/workflows/**.yaml"
             - "pyproject.toml"
@@ -80,7 +84,7 @@ jobs:
                   python -m pip install --upgrade pip
                   python -m pip install --upgrade '.[test]'
             - name: Run unit tests
-              run: python -m pytest tests/test_units.py -ra
+              run: python -m pytest tests -ra --ignore=tests/test_snapshots.py
 
     # convergence: poxy's whole reason to exist is to normalize away doxygen's version-to-version differences,
     # so the canonical expected_* golden must be reproduced byte-for-byte by EVERY supported doxygen version.
 
@@ -0,0 +1,20 @@
+See @README.md for a description of this project.
+
+See @CONTRIBUTING.md for contribution guidelines.
+
+Comments in code should be terse and to-the-point, documenting _why_, not _what_:
+
+- Primarily lowercase (language snippets excepted)
+- At most 1-2 lines, no paragraphs unless absolutely necessary
+- If a comment adds no value, DO NOT LEAVE ONE.
+- No LLM voice slop
+- No over-embellishing
+- No re-explaining things that are plainly obvious from the code itself
+- No using things like backticks - code isn't markdown
+- No using unicode (no em dashes, en dashes, arrows, or anything else non-ASCII)
+- No excessive punctuation (language snippets excepted)
+- Comments in unit-tests can often be folded into TEST_CASE or SECTION names
+- NO LLM VOICE SLOP
+
+ANY COMMENTS THAT DO NOT MEET THE ABOVE CRITERIA SHOULD BE CONSIDERED A BUG AND AGGRESSIVELY FLAGGED DURING REVIEW.
+Obviously-human comments like in-jokes, banners/headers and slang are fine.
@@ -1,5 +1,25 @@
 # Changelog
 
+## v0.26.0 - 2026-09-05
+
+- fixed markdown heading 'autodoc' using doxygen's unstable algorithm, replaced with a better implementation
+- fixed an indented code block being read as a heading
+- fixed `poxy_changelog.html` being named `md_poxy_changelog.html` on some doxygen versions
+- fixed `sources.strip_paths` being ignored entirely when a config had no `[sources]` table
+- fixed `poxyblog --version` exiting with an error instead of printing the version
+- fixed `poxyblog` writing to `./blog` rather than the blog directory poxy reads from
+- fixed `poxyblog` accepting a multi-line title, and generating filenames poxy would later reject
+- fixed blog post images being resolved by basename
+- fixed markdown heading anchors sharing doxygen's global section-label namespace
+- fixed a markdown page's title heading being labelled, which renamed the page's output file
+- fixed an explicit `{#label}` on a blog post's or changelog's title heading being discarded
+- added blog front matter (TOML, fenced by `+++`) with `title`, `date`, `slug`, `draft`, `description`, `tags` and `aliases`
+- added blog post directories, so a post's images and other media can live beside its text
+- added a blog index page, tag pages, per-post date/tag bylines, excerpts and prev/next navigation
+- added `feed.xml` (RSS 2.0), `sitemap.xml` and `404.html`
+- added the `blog`, `site_url` and `sitemap` config options
+- added `--drafts`
+
 ## v0.25.1 - 2026-08-05
 
 - fixed `#MACRO` refs not working from page bodies
 
@@ -1,20 +1 @@
-See @README.md for a description of this project.
-
-See @CONTRIBUTING.md for contribution guidelines.
-
-Comments in code should be terse and to-the-point, documenting _why_, not _what_:
-
-- Primarily lowercase (language snippets excepted)
-- At most 1-2 lines, no paragraphs unless absolutely necessary
-- If a comment adds no value, DO NOT LEAVE ONE.
-- No LLM voice slop
-- No over-embellishing
-- No re-explaining things that are plainly obvious from the code itself
-- No using things like backticks - code isn't markdown
-- No using unicode (no em dashes, en dashes, arrows, or anything else non-ASCII)
-- No excessive punctuation (language snippets excepted)
-- Comments in unit-tests can often be folded into TEST_CASE or SECTION names
-- NO LLM VOICE SLOP
-
-ANY COMMENTS THAT DO NOT MEET THE ABOVE CRITERIA SHOULD BE CONSIDERED A BUG AND AGGRESSIVELY FLAGGED DURING REVIEW.
-Obviously-human comments like in-jokes, banners/headers and slang are fine.
+@AGENTS.md
@@ -35,6 +35,7 @@ a fantastic live search feature. **Poxy** builds upon both by:
 -   Adding support for C++20 concepts
 -   Adding [tabbed content blocks](docs/aliases.md#tabbed-content) (e.g. for showing the same example in multiple languages)
 -   Adding a top-level page listing all `#defines` so they're discoverable without hunting through file docs
+-   Adding a [blog](docs/blog.md) with tags, drafts, per-post media, an RSS feed and a sitemap
 -   Self-hosting fonts to reduce external HTTP requests
 -   Inlining SVGs so they can take advantage of [`currentColor`]
 -   Keeping undocumented parents of documented symbols (and documented enums' values) instead of pruning them
@@ -72,9 +73,10 @@ pip install poxy
 Poxy is a command-line application.
 
 ```
-usage: poxy [-h] [-v] [--html | --no-html] [--ppinclude <regex>] [--ppexclude <regex>]
-            [--theme {light,dark,custom}] [--threads N] [--version] [--xml | --no-xml]
-            [--werror | --no-werror] [--bug-report] [--git-tags]
+usage: poxy [-h] [-v] [--html | --no-html] [--ppinclude <regex>]
+            [--ppexclude <regex>] [--theme {light,dark,custom}] [--threads N]
+            [--version] [--xml | --no-xml] [--werror | --no-werror]
+            [--drafts | --no-drafts] [--bug-report] [--git-tags]
             [--squash-patches | --no-squash-patches] [--min-version <version>]
             [config]
 
@@ -83,7 +85,7 @@ usage: poxy [-h] [-v] [--html | --no-html] [--ppinclude <regex>] [--ppexclude <r
  | |_) | (_) >  <| |_| |
  | .__/ \___/_/\_\\__, |
  | |               __/ |
- |_|              |___/  v0.17.0 - github.com/marzer/poxy
+ |_|              |___/  v0.25.1 - github.com/marzer/poxy
 
 Generate fancy C++ documentation.
 
@@ -103,6 +105,8 @@ options:
   --xml, --no-xml       specify whether XML output is required
   --werror, --no-werror
                         treat warnings as errors (default: read from config)
+  --drafts, --no-drafts
+                        include blog posts marked as drafts (default: read from config)
   --bug-report          captures all output in a zip file for easier bug reporting.
   --git-tags            add git-tag-based semver version switcher to the generated HTML
   --squash-patches, --no-squash-patches
@@ -127,12 +131,28 @@ Full documentation lives in the [`docs`](docs) directory:
 
 -   [What poxy does over Doxygen + m.css](docs/improvements.md)
 -   [Configuration options](docs/configuration.md) - every `poxy.toml` option
+-   [Blog](docs/blog.md) - writing posts, tags, drafts and feeds
 -   [Doxygen @alias commands](docs/aliases.md) - the extra `@commands` poxy provides
 -   [Square-bracket tags](docs/tags.md) - inline control of the generated HTML
 
 For a self-contained `poxy.toml` example to copy and paste from,
 see [the one used by toml++](https://github.com/marzer/tomlplusplus/blob/master/docs/poxy.toml).
 
+### Blogging
+
+Poxy doubles as a small static blogging platform. `poxyblog` scaffolds a post:
+
+```
+usage: poxyblog [-h] [--tags <a,b,c>] [--date <YYYY-MM-DD>] [--draft] [--dir]
+                [--force] [-v] [--version]
+                [config] [title]
+
+Initializes a new blog post for Poxy sites.
+```
+
+Posts are markdown with optional TOML front matter, and get an index, tags, an RSS feed and a sitemap.
+See the [blog documentation](docs/blog.md).
+
 <br><br>
 
 ## Migrating from Doxygen
 
@@ -1 +1 @@
-0.25.1
+0.26.0
@@ -2,6 +2,7 @@
 
 - [What poxy does over Doxygen + m.css](improvements.md) - the features and fixes poxy adds.
 - [Configuration options](configuration.md) - every option available in a `poxy.toml`.
+- [Blog](blog.md) - writing posts, tags, drafts and feeds.
 - [Doxygen @alias commands](aliases.md) - the extra `@commands` poxy provides.
 - [Square-bracket tags](tags.md) - inline control of the generated HTML.