pyandoc

What it is and what it does

Pyandoc is a thin Python wrapper around Pandoc, the universal document converter. It exposes document formats as properties on a Document object, letting you read content in one format and write it out in another by simple attribute assignment. For example, you can load Markdown, then access the `.rst` property to get reStructuredText output, or `.html` for HTML.

The package has no Python runtime dependencies—it relies entirely on Pandoc being installed on your system. It was last released on 2016-02-04 and is no longer maintained; the repository is archived. While it still appears in download statistics, its age and lack of updates mean it may not work smoothly with modern Python versions or recent Pandoc releases.

Use it for:

• Convert Markdown documentation to reStructuredText for Sphinx-based projects.
• Batch-convert document collections between formats (e.g., Markdown to HTML or LaTeX).
• Build documentation pipelines that need to output multiple formats from a single source.
• Automate format conversion in legacy Python 2 or early Python 3 projects where Pandoc is deployed.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Pyandoc wraps Pandoc to convert between document formats by reading from and writing to a Document object's format properties.

No. The package is abandoned (last update 2016-02-04) and untested against Python versions beyond 3.5. While it has no known vulnerabilities and carries a permissive license, its age and lack of maintenance create real risk of incompatibility with modern Python and Pandoc. For new projects, call Pandoc directly via subprocess or use a maintained alternative; for legacy systems where it already works, keep it but do not expand its use.

Install

pyandoc on PyPI

pip install pyandoc

uv add pyandoc

poetry add pyandoc

Installing pyandoc

Before you install

Installation requires Pandoc to be present on the system; the package itself has no Python dependencies but is abandoned since 2016 and last tested against Python 3.5, raising compatibility concerns with modern Python versions.

License in practice

MIT license is permissive and imposes no restrictions on use, modification, or distribution in your own projects.

Quickstart

import pyandoc

doc = pyandoc.Document()
doc.markdown = '# Heading\n\nSome text'
print(doc.rst)

Pandoc must be installed and available on the system PATH; pyandoc will attempt to locate it automatically.

Verify before relying

• Whether pyandoc works reliably with modern Python versions despite classifiers only claiming up to 3.5.
• Current status of automatic Pandoc discovery on Windows, macOS, and Linux systems.
• Whether all listed output formats remain supported by current Pandoc versions.

Package facts

Evidence: pyandoc-0.2.0.tar.gz

Tags

More Markup packages