markupsprog

Markupsprog is a markup-driven programming paradigm and associated language designed to describe software systems in a single, language-agnostic source. Writers embed markup annotations alongside prose to specify code structure, interfaces, and deployment constraints, from which source code can be generated for multiple target languages. The approach is aimed at aligning documentation, design, and implementation.

Markupsprog documents typically consist of narrative sections interleaved with tagged blocks that declare data models, functions, and orchestration logic. The markup acts as a lightweight meta-language: tags indicate module boundaries, type information, and dependencies, while embedded code samples show concrete implementations. The system provides templates and rules for generating idiomatic code in chosen target languages, and may support round-tripping to re-import generated code back into the document.

Common features include declaration of modules and interfaces, automatic scaffolding of project structure, cross-language code generation, and validation of dependencies. Toolchains range from simple generators to integrated development environments that render previews and checks, with support for static analysis and type checking in the generated output. Markupsprog emphasizes separation of intent and presentation, enabling teams to maintain design notes alongside executable constructs.

Usage typically involves authoring a single source of truth describing the system architecture, data models, and algorithms, followed by a build step that emits source files, tests, and documentation. The approach is used primarily in environments that value strong traceability between design and implementation, and in projects that require multi-language outputs from a shared specification.

See also: literate programming, model-driven development, code generation, markup languages.