Metadata-Version: 2.1
Name: markdownpy
Version: 0.1.4
Summary: PyPI package to write Markdown document directly from a Python script
Home-page: https://github.com/aidanjungo/Markdownpy
Author: Aidan Jungo
Author-email: aidan.jungo@cfse.ch
License: Apache License 2.0
Keywords: Markdown,Python,documentation
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Developers
Classifier: Topic :: Text Processing :: Markup :: Markdown
Requires-Python: >=3.8.0
Description-Content-Type: text/markdown
License-File: LICENSE

[![PyPi version](https://img.shields.io/pypi/v/markdownpy.svg)](https://pypi.python.org/pypi/markdownpy)
[![License](https://img.shields.io/badge/license-Apache%202-blue.svg)](https://github.com/aidanjungo/Markdownpy/blob/main/LICENSE)
[![Black code style](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
# Markdownpy

Simple Python package to write Markdown document directly from a Python script.

<div align=center><img src="logo/markdownpy_logo.png" alt="" height=300/></div>

## Install

### Locally

Clone the repository install it with pip:

```bash
git clone git@github.com:aidanjungo/Markdownpy.git
cd Markdownpy
pip install -e .
```

### From PyPi

You can install the last version of `Markdownpy` with pip:

```python
pip install markdownpy
```

## Usage

You can import and use the package in any Python script and use it to generate result or documentation files on the fly.

```python
from markdownpy.markdownpy import MarkdownDoc

md = MarkdownDoc("MySimpleMarkdown.md")

md.h1("H1 title")
md.h2("H2 title")
md.p("paragraph")

md.h2("Lists")

mylist = []
for i in range(5):
    mylist.append(f"item_{i}")

md.blist(mylist)

md.save()

```

From more example, checkout [example.py](examples/example.py)

By the way, this README has been generated using `Markdownpy`, you can see the python script here: [readme.py](examples/readme.py)

