CNL-TN-2025-006 Technical Note

Smart Markdown: Dynamic Variable Substitution for Living Documents

Michael P. Hamilton , Ph.D.
Published: December 5, 2025 Version: 1

Abstract

This technical note describes Smart Markdown, a lightweight implementation of dynamic variable substitution for markdown-based content management systems. The system allows authors to embed tokens (e.g., `{{essay_count}}`) within document content that resolve to current database values at render time, creating "living documents" that remain accurate without manual updates. The approach draws inspiration from Ted Nelson's concept of transclusion—the inclusion of content by reference rather than by copy—and represents a practical implementation of ideas first articulated in the early hypertext literature. This document provides theoretical grounding, implementation specifications, and integration patterns for the Coffee with Claude (CWC) blog infrastructure.

---

Access

AI Collaboration Disclosure

Claude (Anthropic ) — Analysis

This technical note was developed with assistance from Claude (Anthropic). The AI contributed to historical research, code patterns, and documentation drafting. The author takes full responsibility for the content, accuracy, and conclusions.

Human review: full

Cite This Document

Michael P. Hamilton, Ph.D. (2025). "Smart Markdown: Dynamic Variable Substitution for Living Documents." Canemah Nature Laboratory Technical Note CNL-TN-2025-006. https://canemah.org/archive/CNL-TN-2025-006

BibTeX

@techreport{hamilton2025smart, author = {Hamilton, Michael P., Ph.D.}, title = {Smart Markdown: Dynamic Variable Substitution for Living Documents}, institution = {Canemah Nature Laboratory}, year = {2025}, number = {CNL-TN-2025-006}, month = {december}, url = {https://canemah.org/archive/document.php?id=CNL-TN-2025-006}, abstract = {This technical note describes Smart Markdown, a lightweight implementation of dynamic variable substitution for markdown-based content management systems. The system allows authors to embed tokens (e.g., `{{essay\_count}}`) within document content that resolve to current database values at render time, creating "living documents" that remain accurate without manual updates. The approach draws inspiration from Ted Nelson's concept of transclusion—the inclusion of content by reference rather than by copy—and represents a practical implementation of ideas first articulated in the early hypertext literature. This document provides theoretical grounding, implementation specifications, and integration patterns for the Coffee with Claude (CWC) blog infrastructure.} }

Permanent URL: https://canemah.org/archive/document.php?id=CNL-TN-2025-006