Library to convert rich text from Draft.js raw ContentState to Markdown, based on draftjs_exporter
Project description
Draft.js exporter 🐍 - Markdown edition
Library to convert rich text from Draft.js raw ContentState to Markdown, based on Draft.js exporter.
🚧 This is an experimental exporter with limited Markdown support – please use with caution.
Usage
This package is a Markdown export configuration for the Draft.js exporter. Specifically, it provides:
- A Markdown-friendly exporter engine, with fallbacks to HTML tags.
- Configuration for basic Markdown formatting.
First, install the package:
pip install draftjs_exporter_markdown
Then, to convert Draft.js content to Markdown:
And in Python:
from draftjs_exporter.html import HTML
from draftjs_exporter_markdown import BLOCK_MAP, ENGINE, ENTITY_DECORATORS, STYLE_MAP
# Initialise the exporter.
exporter = HTML({
# Those configurations are overridable like for draftjs_exporter.
'block_map': BLOCK_MAP,
'style_map': STYLE_MAP,
'entity_decorators': ENTITY_DECORATORS,
'engine': ENGINE,
})
markdown = exporter.render({
'entityMap': {},
'blocks': [{
'key': '6mgfh',
'text': 'Hello, world!',
'type': 'unstyled',
'depth': 0,
'inlineStyleRanges': [],
'entityRanges': []
}]
})
print(markdown)
You can also run an example by downloading this repository and then using python example.py
.
Configuration
Please refer to the Draft.js exporter configuration documentation.
Supported Markdown formatting
The built-in configuration provides support for:
- Inline styles: bold, italic, strikethrough, code
- Blocks: paragraphs, heading levels, bullet and number lists, code blocks, blockquote
- Images, links, and horizontal rules
Contrary to the main Draft.js exporter,
- Nested / overlapping styles aren't supported.
- None of the content is escaped (HTML escaping is unnecessary for Markdown, and there is no Markdown escaping).
Development
Requirements:
virtualenv
,pyenv
,twine
git clone git@github.com:thibaudcolas/draftjs_exporter_markdown.git
cd draftjs_exporter_markdown/
# Install dependencies
nvm install
npm install
# For tests and development in watch mode.
npm install -g nodemon
# Install the Python environment.
virtualenv .venv
source ./.venv/bin/activate
make init
# Install required Python versions
pyenv install --skip-existing 3.6.3
# Make required Python versions available globally.
pyenv global system 3.6.3
# Run the built-in example.
make dev
Releases
Use make release
, which uses standard-version to generate the CHANGELOG and decide on the version bump based on the commits since the last release.
Credits
View the full list of contributors. MIT licensed.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for draftjs_exporter_markdown-0.2.4.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 13d2d93f7e8d200e6f717b98352bf41cbbe730faeb9fa0a04decd28b888b4a98 |
|
MD5 | bf2f42e7bc4c8538e7b0f54e4ff28518 |
|
BLAKE2b-256 | ce80141b6b0b0a7e41a1f2bc4c06656411d5a4f77c052e724a3e05550406a4ac |
Hashes for draftjs_exporter_markdown-0.2.4-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 85ef894a57a9d3f1d26572d8ecc2873d643d06cc0fbf41d80778c1e4d63954d9 |
|
MD5 | bc99116cbe9a98e1fa79f55737de95fb |
|
BLAKE2b-256 | cbcc3bd94f14f5d443b9b2bb5660592574641969158e6f219c853e46710571e0 |