I do something like this with Asciidoc's include directive, but including to a tagged region in the source, with the tags in a block comment. The include lives in a code block, so it gets formatted right.
Asciidoc document:
// Asciidoc begins
= Test include to code
Here's a paragraph. Let's take a look at a code block plus an include
[source, python]
----
include::loops.py[tag=count]
----
# Python begins
# // tag::count[]
count = 0
# // end::count[]
while count < 5:
print(count)
count += 1 # This is the same as count = count + 1
Test include to code
Here’s a paragraph. Let’s take a look at a code block plus an include
count = 0