Textile

Warnings

• breaking Python 2.x and older Python 3.x versions (3.2, 3.3, 3.4) are no longer supported. Users on these environments should use Textile Version 3.0.
  Fix: Upgrade to Python 3.8+ or pin to `textile<4.0.0` for older Python versions.
• breaking The underlying HTML sanitization library was switched from `html5lib` to `nh3`. This might subtly change sanitization behavior for some inputs.
  Fix: Review HTML output if your application relies on specific sanitization rules. Adjust inputs or sanitize pre/post-processing if necessary.
• gotcha The `regex` package, an optional dependency, can cause compatibility problems when running `textile` in PyPy environments. If you encounter issues, uninstall `regex`.
  Fix: In PyPy environments, run `pip uninstall regex` if `textile` functionality is affected.

Install

• pip install textile Install stable version
• pip install 'textile[imagesize]' Install with optional image size dependency (Pillow)

Imports

• textile

  import textile

  The main module and the primary function share the same name.

Quickstart

Initialize the textile parser and convert a sample Textile string to HTML.

import textile

textile_input = """
_This_ is a *test.*\n
* One
* Two
* Three

Link to "Slashdot":http://slashdot.org/
"""

html_output = textile.textile(textile_input)
print(html_output)