If you know "how to make headings and links and etc..." then just do that. Save your Perl script or module or whatever it is you're writing the POD as part of. Then just run:

perldoc my_file_name

[download]

For example, I put POD in a script I call dtach.pl. From the command line, I just type:

perldoc dtach.pl

[download]

And the POD is displayed nice and formatted as perldoc pages.

If you're looking for something else, there are a bunch of pod2xxx utilities, where xxx = html, ps, man, etc... to convert POD to output files of the specific utility's type. I use pod2html pretty regularly to post POD pages on my web site.

In reply to Re: POD: For Beginners by VinsWorldcom
in thread POD: For Beginners by perl.j

Title:
Use:  <p> text here (a paragraph) </p>
and:  <code> code here </code>
to format your post, it's "PerlMonks-approved HTML":


  • Posts are HTML formatted. Put <p> </p> tags around your paragraphs. Put <code> </code> tags around your code and data!
  • Titles consisting of a single word are discouraged, and in most cases are disallowed outright.
  • Read Where should I post X? if you're not absolutely sure you're posting in the right place.
  • Please read these before you post! —
  • Posts may use any of the Perl Monks Approved HTML tags:
    a, abbr, b, big, blockquote, br, caption, center, col, colgroup, dd, del, details, div, dl, dt, em, font, h1, h2, h3, h4, h5, h6, hr, i, ins, li, ol, p, pre, readmore, small, span, spoiler, strike, strong, sub, summary, sup, table, tbody, td, tfoot, th, thead, tr, tt, u, ul, wbr
  • You may need to use entities for some characters, as follows. (Exception: Within code tags, you can put the characters literally.)
            For:     Use:
    & &amp;
    < &lt;
    > &gt;
    [ &#91;
    ] &#93;
  • Link using PerlMonks shortcuts! What shortcuts can I use for linking?
  • See Writeup Formatting Tips and other pages linked from there for more info.