Summary
Add support for executing shell commands from Markdown code blocks during the documentation build and rendering the captured output back into the document.
Problem / Motivation
Documentation examples often show commands that can drift from actual behavior over time. If shell blocks can be executed at build time, the documentation can show verified command output rather than manually copied output.
This helps make documentation a checked, executable artifact rather than static prose.
Proposed Solution
Support an executable shell block syntax and output like:
```bash | litdoc -l text
echo "hello, world"
```
<!--- BEGIN LITDOC OUTPUT -->
```text
hello, world
```
<!--- END LITDOC OUTPUT -->
Acceptance Criteria
Summary
Add support for executing shell commands from Markdown code blocks during the documentation build and rendering the captured output back into the document.
Problem / Motivation
Documentation examples often show commands that can drift from actual behavior over time. If shell blocks can be executed at build time, the documentation can show verified command output rather than manually copied output.
This helps make documentation a checked, executable artifact rather than static prose.
Proposed Solution
Support an executable shell block syntax and output like:
Acceptance Criteria