Skip to main content

*Extremely* _simple_ markdown-ish format

Project description

CircleCI

dumbdown

Extremely simplified quasi-markdown to HTML parsing, available in both Javascript and Python.

Installation

To install the python package:

pip install dumbdown

To install the npm package:

npm install dumbdown

Demo

To see the demo: clone this repo, install node modules from package.json and open demo.html in your favorite browser. Try typing some text with * and _ characters.

Usage

It allows 3 kinds of formatting marks, bold, italic, and > blockquotes but it uses Slack's syntax for these and not Markdown syntax.

Bold text must have * surrounding it:

For example, *this would be bold*.

Italicized text has _ surrounding it:

And _this would be in italics_.

Bold and italics can be nested within each other:

*bold _bold-italics_*, _italics with some *bold* inside_. *_Nice!_*.

A blockquote is a line starting with >:

> this is a blockquote
> woo

Python API

The Python version provides two functions: to_html and to_plain.

>>> from dumbdown import to_html, to_plain

>>> to_html("*This is bold _this is bold ital._*\nThis is on a new line")
'<p><strong>This is bold <i>this is bold ital.</i></strong></p><p>This is on a new line</p>'

>>> to_plain("*This is bold _this is bold ital._*\nThis is on a new line")
'This is bold this is bold ital. This is on a new line'

Javascript API

The Javascript version provides two functions: toHtml and toPlain.

>>> import { toHtml, toPlain } from "dumbdown";

>>> toHtml("*This is bold _this is bold ital._*\nThis is on a new line");
'<p><strong>This is bold <i>this is bold ital.</i></strong></p><p>This is on a new line</p>'

>>> toPlain("*This is bold _this is bold ital._*\nThis is on a new line")
'This is bold this is bold ital. This is on a new line'

Testing

To test:

Python

pytest

Javascript

yarn run test

Releasing

Python / PyPi

Build

python setup.py sdist bdist_wheel

Release

twine upload dist/*

Javascript / NPM

Build

yarn run build

Release

npm publish

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

dumbdown-1.1.8.tar.gz (5.3 kB view details)

Uploaded Source

File details

Details for the file dumbdown-1.1.8.tar.gz.

File metadata

  • Download URL: dumbdown-1.1.8.tar.gz
  • Upload date:
  • Size: 5.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.10.8

File hashes

Hashes for dumbdown-1.1.8.tar.gz
Algorithm Hash digest
SHA256 d8c475ece22c9766f28c9ae5c21dc06d681ac704778b978f561345398a79aa4c
MD5 085905ad48b970c5fb4b0da2f01f931a
BLAKE2b-256 db3d0387ecc2f2182314452ee40375f01a6a1941d3b20fdc3b47be8742566faf

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page