Metadata-Version: 2.4
Name: mdutils
Version: 1.8.0
Summary: Useful package for creating Markdown files while executing python code.
Home-page: https://github.com/didix21/mdutils
Author: Didac Coll
Author-email: didaccoll_93@hotmail.com
Maintainer: Didac Coll
Maintainer-email: didaccoll_93@hotmail.com
License: MIT
Project-URL: Documentation, http://mdutils.readthedocs.io
Project-URL: Say Thanks!, https://github.com/didix21/
Project-URL: Source, https://github.com/didix21/mdutils
Platform: Python 3.6
Platform: Python 3.7
Platform: Python 3.8
Classifier: Development Status :: 5 - Production/Stable
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Topic :: Utilities
Classifier: Topic :: Software Development :: Documentation
Classifier: Topic :: Text Processing :: Markup
Classifier: License :: OSI Approved :: MIT License
License-File: LICENSE.txt
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: home-page
Dynamic: license
Dynamic: license-file
Dynamic: maintainer
Dynamic: maintainer-email
Dynamic: platform
Dynamic: project-url
Dynamic: summary

=======
mdutils
=======
|build-status| |documentation-status| |coverage-status|

.. contents:: Table of Contents

Overview
========
This Python package contains a set of basic tools that can help to create a markdown file while running a Python code.
Thus, if you are executing a Python code and you save the result in a text file, Why not format it? So
using files such as Markdown can give a great look to those results. In this way, mdutils will make things easy for
creating Markdown files.

- Project Homepage: https://github.com/didix21/mdutils
- Download Page: https://pypi.python.org/pypi/mdutils
- Documentation: http://mdutils.readthedocs.io/en/latest/

MIT License, (C) 2018 Didac Coll <didaccoll_93@hotmail.com>

Features
========
There are some different features available on that version of mdutils:

Writing and Reading Files
-------------------------
- Write and Read Markdown files.
- Append data to the end of a Markdown file.
- Use markers to place text.

Markdown
--------
- Implemented method to give format to the text: bold, italics, change color...
- Align text.
- Add headers of levels 1 til 6 (atx style) or 1 and 2 (setext style).
- Create tables.
- Create a table of contents.
- Add Links.
- Add Lists.
- Add Markdown Images.
- Add Html Images.

.. note::

    Some available features will depen on which CSS you are using. For example, GitHub do not allows to give color to text.


Installation
============

Pip
---
Use pip to install mdutils:

.. code:: bash

    $ pip install mdutils

Poetry
------
Use poetry to install mdutils:

.. code:: bash

    $ poetry add mdutils


.. |build-status| image:: https://github.com/didix21/mdutils/actions/workflows/main.yml/badge.svg
    :target: https://github.com/didix21/mdutils
    :alt: Build Status

.. |documentation-status| image:: https://readthedocs.org/projects/mdutils/badge/?version=latest
    :target: http://mdutils.readthedocs.io/en/latest/?badge=latest
    :alt: Documentation Status

.. |coverage-status| image:: https://codecov.io/gh/didix21/mdutils/branch/master/graph/badge.svg?token=0DN72Z1B6V
    :target: https://codecov.io/gh/didix21/mdutils
    :alt: Coverage Status
