The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.


Formatter::HTML::Preformatted - Absolute minimal HTML formatting of pure text


  use Formatter::HTML::Preformatted;
  my $formatter = Formatter::HTML::Preformatted->format($data);
  print $formatter->fragment;
  my @links = $text->links;
  print ${$links}[0]->{url};


This module will simply take any text-string and put it in a HTML pre element. It will escape tags and entities. It will also look through it to see if there are any URIs, and they will be turned into hyperlinks.


This module conforms with the Formatter API specification, version 0.95:


The format function that you call to initialise the formatter. It takes the plain text as a string argument and returns an object of this class.


To get only the text enclosed in the minimal pre element, you will call this method. It returns a string with the HTML fragment.


Will add a document type declaration and some minimal markup, to return a full, valid, HTML document. You may specify an optional $charset parameter. This will include a HTML meta element with the chosen character set. It will still be your responsibility to ensure that the document served is encoded with this character set.

Will return all links found the input plain text string. They will be found in an arrayref where each element has a key url.


Since this formatter has no way of finding the title of the document this method will always return undef.


Formatter, Formatter::HTML::Textile, URI::Find::Simple


Kjetil Kjernsmo, <>


Copyright (C) 2004-2005 by Kjetil Kjernsmo

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.4 or, at your option, any later version of Perl 5 you may have available.