MarkupPy: An HTML/XML Generator

1.18 · active · verified Mon Apr 13

MarkupPy is a Python module designed to simplify the generation of HTML/XML from Python code in an intuitive, lightweight, and Pythonic manner. It supports both Python 2 and 3 environments, offering a straightforward approach to creating markup. The library maintains an active status with intermittent releases, with version 1.18 being published in March 2025.

Warnings

gotcha MarkupPy is a lightweight generator and not intended as a full-blown web framework, templating engine, or XML parser. For robust production environments or complex needs, alternatives like ElementTree are suggested.
Fix: Align usage with the library's intended lightweight purpose; consider other tools for complex production scenarios.
gotcha When adding content to `<pre>` tags, versions prior to 1.17 might insert extra newlines between additions. Use the `add_raw()` method (available from v1.17+) to preserve exact formatting without unwanted newlines.
Fix: Upgrade to MarkupPy 1.17+ and use `page.add_raw('your raw content\n')` for pre-formatted text.
gotcha Direct embedding of inline CSS and JavaScript content via the `init()` method's `style_content` and `script_content` arguments is only supported in version 1.16 and newer.
Fix: For older versions, manual methods (e.g., adding `<style>` or `<script>` tags directly with `page.add()` or similar) would be required, or upgrade to 1.16+.
gotcha Due to the existence of the `page.add()` method for inserting raw text, 'add' cannot be used as an HTML/XML element name (e.g., `page.add(...)` for creating an `<add>` tag) as it would clash with the method.
Fix: Avoid using 'add' as a custom element name; choose a different, non-conflicting name.
gotcha While MarkupPy states compatibility with Python 2 and 3, Python 2 has reached End-of-Life. It is strongly recommended to use MarkupPy with Python 3 for modern development and security.
Fix: Migrate your project to Python 3. MarkupPy's functionality is fully supported in Python 3.

Install

pip install MarkupPy Install with pip

Imports

markup
```
from MarkupPy import markup
```
The primary class to interact with is 'markup.page()', which resides within the 'MarkupPy' package, not a direct 'markuppy' module.

Quickstart

This example demonstrates how to initialize an HTML page, add a title, paragraphs, and a link. Elements are added as method calls on the page object. Closing tags are explicitly called for block elements like 'p'.

from MarkupPy import markup

# Create an HTML page
page = markup.page()
page.init(title="My Title", lang="en")
page.h1("Welcome!")
page.p("Hello, World!")
page.p.close()
page.a("Visit GitHub", href="https://github.com/tylerbakke/MarkupPy")
print(page)

view raw JSON →