Markdown wins: Better in spreadsheeting than spreadsheet

说明与用途

Markdown 成为唯一的无误差计算来源，消除了手动复制粘贴，并在 CI 中实现自动验证。

问题

Synchronizing a single numeric value between a Markdown README and a spreadsheet calculation was cumbersome and error‑prone.

结果

The Markdown file became the single source of truth for the break‑even calculation, eliminating manual copy‑paste, reducing errors, and enabling automated validation in the CI pipeline.

工作流

• 1. Write the calculation in VisiMark syntax inside the Markdown file.
• 2. Run visimark check to validate values and assertions.
• 3. Use visimark fmt to rewrite the Markdown with updated numbers.
• 4. Export the values as JSON with visimark eval --json for downstream use.
• 5. Integrate the JSON export into the build pipeline to halt on assertion failures.

证据

The JSON is a projection of the README, not a second document, so it cannot drift.

来源

visimark eval --json exits 1 while the assert is false, which means the build stops before billing quotes a price the cap forbids.

来源