Markdownからドキュメントを生成するmdBookというRustでできたツールがあります。 このリポジトリはmdBookを利用したPerlの日本語ドキュメントのためのテンプレートです。
このテンプレートを利用すれば、次のようなPerlのコードの実行結果を確かめながら読めるドキュメントが作れます。
利用方法は、このテンプレートをforkし、forkしたテンプレートからリポジトリを作成するのが良いと思います。 mdBookの利用方法は、mdBookのドキュメントを参照してください。
perlの実行には、現在、wandboxを利用しています。 perlのバージョンは、5.36.0です。