Show HN: Minimal documentation tool that expands code blocks in Markdown files

Category: devtools

Tags: markdown, documentation, code-execution, go, cli

Score: 4.8/10 (Innovation: 5, Technical: 4, Documentation: 6, Utility: 4)

docexp is a minimal Go tool that expands code blocks in Markdown files by executing them via user-provided expander scripts. It offers a lightweight alternative to Jupyter Notebooks for documentation, keeping files in plain Markdown and pushing execution complexity to external scripts. The project is in beta and primarily a learning exercise for the author.

Target audience: developers and technical writers who want lightweight, executable documentation

Repository: https://github.com/aartur/docexp · Go · GPL-3.0 · 2 stars

View on Hacker News