---
name: "HTML::FormatText::WithLinks::README"
section: "3pm"
platform: "linux"
package: "libhtml-formattext-withlinks-andtables-perl"
version: "0.07-1"
release: "Debian 11 (Bullseye)"
platforms: ["linux"]
url: "https://new.carta.tech/HTML::FormatText::WithLinks::README"
---

# HTML::FormatText::WithLinks::README(3pm)

Converts HTML to Text with tables intact

## NAME

HTML::FormatText::WithLinks::AndTables - Converts HTML to Text with tables intact

## SYNOPSIS

```
    use HTML::FormatText::WithLinks::AndTables;
    my $text = HTML::FormatText::WithLinks::AndTables->convert($html);
```

Or optionally...

```
    my $conf = { # same as HTML::FormatText excepting below
        cellpadding   => 2,  # defaults to 1
        no_rowspacing => 1,  # bool, suppress vertical space between table rows
    };
    my $text = HTML::FormatText::WithLinks::AndTables->convert($html, $conf);
```

## DESCRIPTION

This module was inspired by HTML::FormatText::WithLinks which has proven to be a useful \`lynx -dump\` work-alike. However one frustration was that no other HTML converters I came across had the ability to deal affectively with HTML \<TABLE\>s. This module can in a rudimentary sense do so. The aim was to provide facility to take a simple HTML based email template, and to also convert it to text with the \<TABLE\> structure intact for inclusion as "multipart/alternative" content. Further, it will preserve both the formatting specified by the \<TD\> tag's "align" attribute, and will also preserve multiline text inside of a \<TD\> element provided it is broken using \<BR/\> tags.

### EXPORT

None by default.

## METHODS

### convert

## EXAMPLE

Given the HTML below ...

```
    <HTML><BODY>
    <TABLE>
        <TR>
            <TD ALIGN="right">Name:</TD>
            <TD>Mr. Foo Bar</TD>
        </TR>
        <TR>
            <TD ALIGN="right">Address:</TD>
            <TD>
                #1-276 Quux Lane,     <BR/>
                Schenectady, NY, USA, <BR/>
                12345
            </TD>
        </TR>
        <TR>
            <TD ALIGN="right">Email:</TD>
            <TD><a href="mailto:foo@bar.baz">foo@bar.baz</a></TD>
        </TR>
    </TABLE>
    </BODY></HTML>
```

... the (default) return value of *convert()* will be as follows.

```
       Name:  Mr. Foo Bar
    Address:  #1-276 Quux Lane,
              Schenectady, NY, USA,
              12345
      Email:  [1]foo@bar.baz
              1. mailto:foo@bar.baz
```

## SEE ALSO

```
    HTML::FormatText::WithLinks
    HTML::TreeBuilder
```

## CAVEATS

```
    * <TH> elements are treated identically to <TD> elements
    * It assumes a fixed width font for display of resulting text.
    * It doesn't work well on nested <TABLE>s or other nested blocks within <TABLE>s.
```

## AUTHOR

Shaun Fryer, `"<pause.cpan.org at sourcery.ca>"` (author emeritus)

Dale Evans, `"<daleevans at cpan.org>"` (current maintainer)

## BUGS

Please report any bugs or feature requests to `"bug-html-formattext-withlinks-andtables at rt.cpan.org"`, or through the web interface at \<http://rt.cpan.org/NoAuth/ReportBug.html?Queue=HTML-FormatText-WithLinks-AndTables\>.  I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

## SUPPORT

You can find documentation for this module with the perldoc command.

```
    perldoc HTML::FormatText::WithLinks::AndTables
```

You can also look for information at:

- •

  RT: CPAN's request tracker

  \<http://rt.cpan.org/NoAuth/Bugs.html?Dist=HTML-FormatText-WithLinks-AndTables\>

- •

  AnnoCPAN: Annotated CPAN documentation

  \<http://annocpan.org/dist/HTML-FormatText-WithLinks-AndTables\>

- •

  CPAN Ratings

  \<http://cpanratings.perl.org/d/HTML-FormatText-WithLinks-AndTables\>

- •

  Search CPAN

  \<http://search.cpan.org/dist/HTML-FormatText-WithLinks-AndTables\>

## ACKNOWLEDGEMENTS

Everybody. :) \<http://en.wikipedia.org/wiki/Standing\_on\_the\_shoulders\_of\_giants\>

## COPYRIGHT & LICENSE

Copyright 2008 Shaun Fryer, all rights reserved.

Copyright 2015 Dale Evans, all rights reserved

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.