in reply to Ignoring embedded POD

Put a leading space (or multiple) on your heredoc lines and regex them away before printing: 

$_ = <<"DOC"; s/^ //msg; print;
 =pod
 stuff here
 =cut
DOC
;;
=pod
stuff here
=cut

[download]

Or maybe comment cards would be better? 

$_ = <<"DOC"; s/^#//msg; print;
#=pod
#stuff here
#=cut
DOC
;;
=pod
stuff here
=cut

[download]
With the rise and rise of 'Social' network sites: 'Computers are making people easier to use everyday'
Examine what is said, not who speaks -- Silence betokens consent -- Love the truth but pardon error.
"Science is about questioning the status quo. Questioning authority".
In the absence of evidence, opinion is indistinguishable from prejudice.

In Section Seekers of Perl Wisdom