After discussion on the PR I realized that this is mostly feasible by using @example blocks for the original purpose of creative interactive plotly plots within documenter.
I created a very small package to simplify the procedure here:
which supports plot objects coming out of one of:
- PlotlyLight
- PlotlyBase
- PlotlyJS
If the PR ends up being merged succesfully it should also be possible to use this within @eval blocks to completely hide the generating code.