Look at Jupyter Notebooks. It has a bit different goal, but the end result is pretty much what you describe. If you are not familiar with it: it's a special ki

Look at Jupyter Notebooks. It has a bit different goal, but the end result is pretty much what you describe. If you are not familiar with it: it's a special kind of IDE primarily for Python (though not exclusively), that allows embedding markdown documentation in the middle of the code. Also, code is split into steps that can be repeated... it's easier to try (or watch some videos), then explaining. But it results in the output you just described.