{"repo":"nushell-prophet/numd","free":true,"listed":false,"github":"https://github.com/nushell-prophet/numd","clone":"git clone https://github.com/nushell-prophet/numd.git","description":"numd - reproducible Nushell Markdown documents","language":"Nushell","stars":49,"topics":["nushell","nushell-module","markdown"],"license":"Unlicense","category":"productivity","readme_excerpt":"numd - reproducible Nushell Markdown documents Execute blocks of nushell code within markdown documents, write results back to your .md document, or output them to the terminal. Quickstart How it works numd render parses the initial file (example), generates a script to execute the found commands (example), executes this script in a new nushell instance, captures the results, updates the initial document accordingly, and/or outputs the resulting document into the terminal along with basic changes stats. Experienced nushell users can understand the logic better by looking at examples. Especially, seeing numd in action describing its own commands. Details on parsing code blocks and displaying the output 1. numd looks for code blocks marked with nu . 2. Code blocks are split into command groups by blank lines (double newlines). Each command group is executed separately. 3. Output from each command group is displayed inline with # = prefix immediately after the command. 4. Multiline commands (pipelines split across lines without blank lines) are treated as a single command group. 5. Plain # comments are preserved; # = output lines are regenerated on each run. 6. Use the separate-block fence option to output results in a separate code block instead of inline. [!NOTE] This readme is a live numd document Generate-regions Besides code blocks, numd can maintain stretches of plain markdown. Write a one-line HTML comment with a Nushell command: On the next numd render the marker expands","default_branch":null,"files":null,"tree":[],"storefront":"/r/nushell-prophet","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/nushell-prophet/numd/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}