Metadata-Version: 2.1
Name: django-markdownit
Version: 0.5.0
Summary: Markdown template filter for Django following CommonMark specs (markdown-it-py).
Home-page: https://github.com/noxan/django-markdownit
License: MIT
Keywords: django,markdown,commonmark
Author: Richard
Author-email: richard@stromer.org
Requires-Python: >=3.12,<4.0
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: django (>=4.0)
Requires-Dist: markdown-it-py (>=3.0.0,<4.0.0)
Requires-Dist: nh3 (>=0.2.14,<0.3.0)
Project-URL: Repository, https://github.com/noxan/django-markdownit
Description-Content-Type: text/markdown

# django-markdownit

Markdown template filter for Django following [CommonMark](https://commonmark.org/) specs.

## Installation

1. Install the package:

    ```bash
    poetry add django-markdownit
    ```
    or using pip:
    ```bash
    pip install django-markdownit
    ```

2. Add `markdownit` to your `INSTALLED_APPS`:

    ```python
    INSTALLED_APPS = [
        # ...
        'markdownit',
    ]
    ```

## Usage

1. Load the template tag library in your template:

    ```django
    {% load markdownit %}
    ```

2. Use the `markdownit` filter on a string:

    ```django
    {{ my_string|markdownit }}
    ```


## Credits

- Inspired by [django-markdownify](https://github.com/erwinmatijsen/django-markdownify/).
- Using [markdown-it-py](https://github.com/executablebooks/markdown-it-py) for Markdown rendering.
- Using [nh3](https://github.com/messense/nh3)/[ammonia](https://github.com/rust-ammonia/ammonia) for HTML sanitization.

