{"id":20962,"library":"atlas-doc-parser","title":"Atlas Doc Parser","description":"A Python library for parsing Atlassian Document Format (ADF) to various output formats like HTML or Markdown. Designed for Confluence Cloud integration. Latest version 1.0.1 supports Python >=3.10,<4.0, with active development on GitHub.","status":"active","version":"1.0.1","language":"python","source_language":"en","source_url":"https://github.com/MacHu-GWU/atlas_doc_parser-project","tags":["atlassian","adf","confluence","parser","html","markdown"],"install":[{"cmd":"pip install atlas-doc-parser","lang":"bash","label":"Install from PyPI"}],"dependencies":[],"imports":[{"note":"Primary function to convert ADF JSON to HTML.","symbol":"parse_adf_to_html","correct":"from atlas_doc_parser import parse_adf_to_html"},{"note":"Convert ADF JSON to Markdown (common for Confluence migration).","symbol":"parse_adf_to_markdown","correct":"from atlas_doc_parser import parse_adf_to_markdown"}],"quickstart":{"code":"from atlas_doc_parser import parse_adf_to_html\n\nadf_json = {\n    \"version\": 1,\n    \"type\": \"doc\",\n    \"content\": [\n        {\n            \"type\": \"paragraph\",\n            \"content\": [\n                {\n                    \"type\": \"text\",\n                    \"text\": \"Hello, world!\"\n                }\n            ]\n        }\n    ]\n}\n\nhtml_output = parse_adf_to_html(adf_json)\nprint(html_output)","lang":"python","description":"Parse a simple ADF document to HTML."},"warnings":[{"fix":"Validate your ADF JSON against Atlassian's schema before parsing.","message":"Input must be a valid ADF JSON structure. Invalid or missing keys may raise KeyError or ValueError.","severity":"gotcha","affected_versions":">=0.1.0"},{"fix":"Check the library's supported node list; use fallback rendering for unsupported nodes.","message":"The library does not support all ADF node types yet (e.g., media, table, blockquote). Unknown nodes are ignored.","severity":"gotcha","affected_versions":"<=1.0.1"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Preprocess the ADF to remove or replace unsupported nodes before parsing.","cause":"The ADF contains a node type (e.g., media) that the parser does not support.","error":"ValueError: Unknown node type: 'media'"},{"fix":"Ensure all text nodes have a 'text' key. Validate ADF structure.","cause":"ADF object missing required 'text' field in a text node.","error":"KeyError: 'text'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}