Skip to main content

Plugin for safe text editing with MKDocs.

Project description

# mkdocs-safe-text-plugin

[![Build Status](](
[![PyPI version](](
[![BSD License](](LICENSE)
[![Requirements Status](](

Plugin for safe text editing with [MKDocs](

## Table of Contents

* [How does this plugin work?](#how-does-this-plugin-work)
* [Installation](#installation)
* [Plugin configuration](#plugin-configuration)
* [License](#license)

## How does this plugin work?

Markdown is a very flexible format, and raw HTML is allowed. But it is unnecessary in multiple-person text editing.

When raw HTML like `<font>` tag is used in MKDocs, it is rendered as it is.

If you use this plug-in with MKDocs, tags that are not allowed in the whitelist are escaped.

## Installation

Install it via PyPI using `pip` command.

$ pip install mkdocs-safe-text-plugin

And add it to your `mkdocs.yml` file.

- mkdocs_safe_text

An example of use can be checked by [example/basic-usage](examples/basic-usage).

## Plugin configuration

This plugin works with the HTML tag element for Markdown defined by [bleach-whitelist]( enabled. This implementation approach is recommended in [the Python-Markdown release notes](

And user can change this setting.

- mkdocs_safe_text:
- tag1
- tag2
- tag3
- tag4
- attribute1
- attribute2

An example of use can be checked by [example/customization-usage](examples/customization-usage).

## License

[BSD 2-Clause License](LICENSE)

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for mkdocs-safe-text-plugin, version 0.4.0
Filename, size File type Python version Upload date Hashes
Filename, size mkdocs_safe_text_plugin-0.4.0-py2.py3-none-any.whl (7.2 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size mkdocs-safe-text-plugin-0.4.0.tar.gz (4.7 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page