{"id":4381,"library":"pyandoc","title":"pyandoc","description":"pyandoc is an unmaintained Python wrapper for Pandoc, the universal document converter. It allows for converting text document formats by interacting with a Document object's attributes. The last release was version 0.2.0 in February 2016, and the project is no longer actively developed. Users seeking a current Pandoc wrapper for Python should consider 'pypandoc' instead.","status":"abandoned","version":"0.2.0","language":"en","source_language":"en","source_url":"http://github.com/kennethreitz/pyandoc","tags":["pandoc","document conversion","text processing","abandoned"],"install":[{"cmd":"pip install pyandoc","lang":"bash","label":"PyPI (unmaintained)"}],"dependencies":[{"reason":"pyandoc is a wrapper and requires a separate installation of Pandoc on the system PATH.","package":"Pandoc","optional":false}],"imports":[{"note":"The primary interaction is through a 'pandoc' module, not directly importing Document from the top-level package.","wrong":"from pyandoc import Document","symbol":"Document","correct":"import pandoc\ndoc = pandoc.Document()"}],"quickstart":{"code":"import pandoc\n\n# Ensure Pandoc is installed and accessible in your system's PATH.\n# For example, on Ubuntu/Debian: sudo apt-get install pandoc\n# Or refer to Pandoc's official installation guide.\n\n# Create a Document object\ndoc = pandoc.Document()\n\n# Assign Markdown content\ndoc.markdown = '''# Hello from pyandoc\n\n* This is a list item\n* Another item with **bold** text'''\n\n# Convert to reStructuredText\nrst_output = doc.rst\nprint(\"\\n--- reStructuredText Output ---\\n\")\nprint(rst_output)\n\n# Convert to HTML\nhtml_output = doc.html\nprint(\"\\n--- HTML Output ---\\n\")\nprint(html_output)","lang":"python","description":"This quickstart demonstrates how to initialize a `pandoc.Document` object, assign content in Markdown, and then convert it to other formats like reStructuredText and HTML by accessing the respective properties. Ensure Pandoc is installed separately on your system for `pyandoc` to function."},"warnings":[{"fix":"Migrate to an actively maintained Pandoc wrapper like 'pypandoc'. This library provides similar functionality and is regularly updated.","message":"Project is abandoned and unmaintained. pyandoc has not been updated since February 2016. It is highly likely to be incompatible with recent Python versions (3.6+) and newer Pandoc releases, leading to runtime errors or unexpected behavior.","severity":"breaking","affected_versions":"0.2.0 (all versions)"},{"fix":"Install Pandoc separately via your system's package manager (e.g., `sudo apt-get install pandoc` on Debian/Ubuntu, `brew install pandoc` on macOS) or by downloading an installer from the official Pandoc website. Verify installation by running `pandoc --version` in your terminal.","message":"Lack of direct Pandoc installation. pyandoc is just a wrapper; it does not install Pandoc itself. Users must manually install Pandoc and ensure it's available in their system's PATH for pyandoc to work. Failure to do so will result in errors when attempting conversions.","severity":"gotcha","affected_versions":"0.2.0 (all versions)"},{"fix":"Avoid using pyandoc in Python 3.x projects. For Python 3.x, use 'pypandoc', which actively supports current Python versions and has dropped Python 2.x support.","message":"Python 2.x compatibility. While pyandoc was released with Python 2.6-3.5 compatibility, Python 2.x is officially end-of-life. Using pyandoc in a modern Python 3 environment without legacy shims is not recommended and may cause issues.","severity":"deprecated","affected_versions":"0.2.0 (all versions)"}],"env_vars":null,"last_verified":"2026-04-12T00:00:00.000Z","next_check":"2026-07-11T00:00:00.000Z"}