---
name: "Template::Plugin::Textile2"
section: "3pm"
platform: "linux"
package: "libtemplate-plugin-textile2-perl"
version: "1.21-6"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Template::Plugin::Textile2"
---

# Template::Plugin::Textile2(3pm)

Use Textile formatting with Template Toolkit

## NAME

Template::Plugin::Textile2 - Use Textile formatting with Template Toolkit

## SYNOPSIS

```
  [% USE Textile2 -%]
  [% FILTER textile2 %]This *bold* and this is _italic_.[% END %]
  <p>this is <strong>bold</strong> and this is <em>italic</em>.
  [% USE Textile2 ( disable_html => 1 ) -%]
  [% FILTER textile2 %]this is<br /> _italic_.[% END %]
  <p>this is&lt;br /&gt; <em>italic</em>.</p>
```

## DESCRIPTION

This module wraps Text::Textile into a plugin Template Toolkit.  It provides a filter named `"textile2"`. This aims to be a more feature-full version Template::Plugin::Textile, by allowing you to pass parameters to Text::Textile.

Use this way:

```
    [% FILTER textile2 %]
    Reasons to use the Template Toolkit:
    * Seperation of concerns.
    * It's written in Perl.
    * Badgers are Still Cool.
    [% END %]
```

or:

```
    [% mytext | textile2 %]
```

You can pass the same options you would pass to Text::Textile, directly when using the template. For instance to disable processing of HTML tags you can do:

```
    [% USE Textile2 ( disable_html => 1 ) %]
```

To avoid your text to be wrapped into `"&lt;p&gt...&lt;/p&gt"` you can use:

```
    [% USE Textile2 ( format_mode => 'inline' ) %]
```

See Text::Textile for details.

## AUTHOR

Michele Beltrame `"mb@italpro.net"`.

## LICENSE

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

## SEE ALSO

Text::Textile, Template
