Я лично использую. Только для питона, а для перла пока не нашёл.

Я писал в контексте перла всё же.

Так в этом плане никакой разницы.

И там и там дерево модулей

Ну вот реально: есть мощный инструмент -- doxygen. Правда, исходный вопрос был про pod и это слегка оффтоп, но если бы сразу использовали doxygen для аннотирования, таких бы вопросов не было.
И ещё я лично с Иваном согласен: под пишут программисты для программистов (для тех, кто не только может будет использовать код, но и менять его внутри), это больше как заметки, а не как документация на «продукт/дистрибутив/называй_как_хошь»

ну вот я сейчас буду ковырять доксиген. Но для него, судя по всему, нужно в спецформате писать, а это сразу геморрой.

а есть возможность конвертнуть весь POD в MD ?

Есть

Но есть один нюанс, который меня бесит

это не сложно

просто есть вот такая штука https://github.com/rust-lang/mdBook
с помощью неё всякие растбуки делают. Получается дико круто

но что это меняет? что-то умеет из маркдауна извлекать и строить красивый сайт с доками?

а, выше вижу

интрига прям)

Если попробуешь, расскажи плиз, как оно

Он код оставляет с пробелами слева, а я хочу, чтобы он их убирал и обрамлял его в
`

Боже храни телеграмм, короче в три backtick

пробежался по диагонали — там надо сначала нагенерить md-файлов? а сайт будет генерировать уже по ним?

не подскажу к сожалению, надо в доку смотреть. Но как я понял, принцип примерно такой, да

ну да, получается лажово. Нужно либо конвертатор патчить либо писать свой, который будет после основного проходить и исправлять