---
name: "wml::fmt::text"
section: "3"
platform: "linux"
package: "wml"
version: "2.32.0~ds1-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/wml::fmt::text"
---

# wml::fmt::text(3)

Plain ASCII with Special Formatting Semantic

## NAME

wml::fmt::text - Plain ASCII with Special Formatting Semantic

## SYNOPSIS

```
 #use wml::fmt::text
 <: print &wml_fmt_text({ FILE => $file, OPTIONS => '--xhtml', ...}); :>
 <text notypo>
 FOO
 ===
 1. bar
 2. quux
    a. baz
    b. foo
 ...
 </text>
```

## DESCRIPTION

The usage is simple: Surround the text with the `"<text>"` container tag and then just write plain ASCII text inside it. The corresponding HTML code is created via *txt2html*(3), a filter which gives the ASCII text nice formatting semantic which control the HTML result.

If **OPTIONS** field is specified, a newer [*txt2html*(1)](/txt2html/1.md) filter is called instead of *txt2html*, which is dead upstream.  This allows for instance generation of XHTML markup.

The core conversion function is **wml\_fmt\_text()** which also can be used by other include files.

## ATTRIBUTES

These attributes can be used both in the `"<text>"` tag (in lowercase letters) and in `"wml_fmt_text"`'s arguments, as shown in the examples above.

- "NOTYPO"

  By default, font commands are added to headings to highlight them. This attribute prevents alteration of *txt2html*'s output.

- "OPTIONS=*str*"

  This attribute performs two actions: select *txt2html* as a filter instead of *txt2html*, and make *str* arguments be passed literally on the command line of *txt2html*.

## AUTHOR

```
 Ralf S. Engelschall
 rse@engelschall.com
 www.engelschall.com
```

## REQUIRES

```
 Internal: P1, P2, P3, txt2html (WML)
 External: --
```

## SEE ALSO

[**txt2html**(1)](/txt2html/1.md)