Metadata-Version: 2.1
Name: marko
Version: 0.3.2
Summary: A markdown parser with high extensibility.
Home-page: https://github.com/frostming/marko
Author: Frost Ming
Author-email: mianghong@gmail.com
License: MIT
Description: Marko
        =====
        > A markdown parser with high extensibility.
        
        [![Build Status](https://travis-ci.org/frostming/marko.svg?branch=master)](https://travis-ci.org/frostming/marko)
        [![PyPI](https://img.shields.io/pypi/v/marko.svg)](https://pypi.org/project/marko/)
        [![Documentation Status](https://readthedocs.org/projects/marko-py/badge/?version=latest)](https://marko-py.readthedocs.io/en/latest/?badge=latest)
        
        Marko is a markdown parser written in pure Python that complies [CommonMark's spec v0.28][spec].
        It is designed to be highly extensible, see [Extend Marko](#extend-marko) for details.
        
        Marko requires Python 3.4 or higher, Python 2.7 support is still in plan but I guess it is not needed.
        
        ## Why Marko
        
        Among all implementations of Python's markdown parser, it is a common issue that user can't easily extend it to add his own features. Furthermore, [Python-Markdown][pymd] and [mistune][mistune] don't comply CommonMark's spec. It is a good reason for me to develop a new markdown parser and use it.
        
        Respecting that Marko complies CommonMark's spec at the same time, which is a super complicated spec, Marko's performance will be affected.
        A benchmark result shows that Marko is 3 times slower than [Python-Markdown][pymd], but a bit faster than [Commonmark-py][cmpy], much slower than [mistune][mistune]. If performance is a bigger concern to you than spec compliance, you's better choose another parser.
        
        [spec]: https://spec.commonmark.org/0.28/
        [pymd]: https://github.com/waylan/Python-Markdown
        [mistune]: https://github.com/lepture/mistune
        [cmpy]: https://github.com/rtfd/CommonMark-py
        
        ## Use Marko
        
        The installation is very simple:
        
            $ pip install marko
        
        And to use it:
        ```python
        from marko import Markdown
        markdown = Markdown()
        print(markdown(text))
        ```
        Marko also provides a simple CLI, for example, to render a document and output to a html file:
        
            $ cat my_article.md | marko > my_article.html
        
        ## Extend Marko
        
        Please refer to [Document](https://marko-py.readthedocs.io/en/latest/extend.html)
        
        ## License
        
        Marko is released under [MIT License](LICENSE)
        
        
        ## Change Log
        
        * v0.3.1: Pangu extension.
        * v0.3.0: Change the entry function to a class, add TOC and footnotes extensions.
        * v0.2.0: Github flavored markdown and docs.
        * v0.1.0: Commonmark spec tests.
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Requires-Python: >=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*
Description-Content-Type: text/markdown
