# markmac > Embed program outputs in markdown Let's say I have a markdown file `README.md` which looks like this: ```md # markmac > Embed program outputs in markdown Let's say I have a markdown file `README.md` which looks like this: If I pipe it through `markmac`, the macro commands will be executed and their STDOUT will be embedded between `` and ``. ```shell cat README.md | markmac > README.md ``` ``` If I pipe it through `markmac`, the macro commands will be executed and their STDOUT will be embedded between `` and ``. ```shell cat README.md | markmac > README.md ```