Metadata-Version: 2.1
Name: mkmd
Version: 0.0.1
Summary: Make Markdown Documents
License: MIT
Project-URL: Repository, https://github.com/phoenixr-codes/mkmd/
Project-URL: Documentation, https://phoenixr-codes.github.io/mkmd/
Keywords: Documentation,Generator,Markdown,Markup
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: Documentation
Classifier: Topic :: Software Development :: Documentation
Classifier: Topic :: Text Processing :: Markup
Classifier: Topic :: Text Processing :: Markup :: Markdown
Classifier: Topic :: Utilities
Classifier: Typing :: Typed
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Provides-Extra: docs

mkmd
====

**M**a**k**e **M**ark**d**own Documents in Python.


Features
--------

* [x] Heading
* [x] Paragraph
* [x] Code Block
* [x] Horizontal Rule
* [x] Reference
* [x] Image
* [x] Unordered List
* [x] Ordered List


Installation
------------

```bash
pip install mkmd
```


Basic Usage
-----------

```python
import mkmd
from mkmd.utils import *

md = mkmd.Markdown()

(md
    .add_heading(f"Hello {bold_and_italic('MKMD')}",)
    
    .add_paragraph(f"""
        This markdown document was generated by using
        {refer('mkmd', '1')}. This is a quick example showing how to
        use it:
    """, wrapped = True)
    
    .add_codeblock("""
        import mkmd
        
        md = mkmd.Markdown()
        md.add_heading("Hello World")
        md.add_paragraph("Lorem ipsum dolor sit amet.")
    """, language = "python")
    
    .add_ordered_list(
        *"So many things are possible!".split()
    )
    
    .add_reference("1", "http://example.org", "Look at this")
    
    .add_image("Linux Mascot",
        "https://mdg.imgix.net/assets/images/tux.png?auto=format&fit=clip&q=40&w=100"
    )
)

if __name__ == "__main__":
    md.save("example_result.md")
```


Links
-----

* [Documentation](https://phoenixr-codes.github.io/mkmd/)
* [PyPI](https://pypi.org/project/mkmd)
* [Repository](https://github.com/phoenixr-codes/mkmd/)
