ext/markdown.py
author David Douard <david.douard@logilab.fr>
Thu, 28 Aug 2014 18:54:21 +0200
changeset 10023 c3ab46842b2d
parent 10012 8c2c6fdd8d56
permissions -rw-r--r--
[book] fix docstrings to please sphinx example rst roles in docstring must be protected (in a literal).

from __future__ import absolute_import
import markdown

import logging

log = logging.getLogger(__name__)


def markdown_publish(context, data):
    """publish a string formatted as MarkDown Text to HTML

    :type context: a cubicweb application object

    :type data: str
    :param data: some MarkDown text

    :rtype: unicode
    :return:
      the data formatted as HTML or the original data if an error occurred
    """
    md = markdown.Markdown()
    try:
        return md.convert(data)
    except:
        import traceback; traceback.print_exc()
        log.exception("Error while converting Markdown to HTML")
        return data