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.

Источник