develooper Front page | perl.perl5.porters | Postings from November 2021

Re: Pre-RFC: markdown in pod

Thread Previous | Thread Next
From:
Ricardo Signes
Date:
November 27, 2021 19:30
Subject:
Re: Pre-RFC: markdown in pod
Message ID:
c974dcb4-624a-4eca-be03-f3cfd242e08b@beta.fastmail.com
On Mon, Nov 22, 2021, at 3:12 PM, Ovid via perl5-porters wrote:
> What if we punted on much of this and allow:
> 
>     =poddown

I mostly want to stay out of this, personally — but here I am posting.

There's a lot to do in "extend Pod with Markdown," and I'm not sure it's really practical.  Of course, I'm not proposing to do it or forbid it, so this isn't my thing to worry about so much.

But I will say that I think that by far the most tedious thing in Pod is lists, for which I provided myself with a solution in Pod::Elemental::Transformer::List <https://metacpan.org/pod/Pod::Elemental::Transformer::List>, which creates a "=begin :list" region or "=for :list" paragraph, which allows very compact notation for bulleted, definition, or ordered lists that uses Pod sequences instead of Markdown, and so remains very much like all other Pod.  Adding support to that to Pod::Simple might be a fair bit simpler than Markdown... but I won't be the one to do it!  🤷🏽‍♂️

-- 
rjbs
Thread Previous | Thread Next


nntp.perl.org: Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at ask@perl.org | Group listing | About