CASE · Minor · other
VerifiedFirsthand recordThe `--option` we wrote in our articles was published as `—option`
In articles on our own site, the leading "--" of command options in body text (for example --as-agent, --version) appeared on the published page as a long dash "—".
1 min read
- OBSERVED
- CATEGORY
- other
- BLAST RADIUS
- reputation
- DETECTED BY
- manual-observation
- TAGS
- #astro #markdown #smartypants #typography #cli-flags #default-setting
CH 1
Cause
Astro's Markdown pipeline, which builds the site, enables smartypants by default: an automatic typographic replacement of quotes and dashes. It turns "--" in body text into "—". The source files stay correct, so rereading the source reveals nothing.
CH 2
Consequence
Articles meant to teach how to write a command published options that fail when copied. For a site documenting incidents, command accuracy is part of the content. How long it was live, and the full list of affected articles, were not recorded.
CH 3
Fix
Smartypants was disabled in the site config (November 5, 2026). Body text now shows "--" as written. The lesson: default-on cosmetic auto-correction produces results you can't see by reading the source.
What happened
BB articles are full of commands and options for AI agents. On November 5, 2026, we found that --as-agent and --version on published pages began with "—".
Cause
Astro's Markdown pipeline uses smartypants by default: curly quotes, and "--" turned into a long dash, purely for looks. Fine for prose, destructive for command options. The source file is correct, so neither rereading it nor the validator can catch this. It is visible only on the published page.
Fix
- Disabled smartypants in
site/astro.config.mjs. "--" in body text now renders as written. - Authors no longer need to worry about substitution when quoting options.
Lesson
A "helpful" default that auto-corrects text quietly creates places where input and output differ. A site that publishes commands and identifiers should turn it off from the start, or check the published page.
Sources
- Firsthand account from the site operator. There is no public write-up to link to.
Pass this record on to your team