{"id":24020,"library":"md2cf","title":"md2cf","description":"Convert Markdown documents to Confluence pages. Current version 2.3.0 supports relative links, automatic retries, and various output modes. Releases are irregular but maintained.","status":"active","version":"2.3.0","language":"python","source_language":"en","source_url":"https://github.com/iamjackg/md2cf","tags":["confluence","markdown","converter","cli"],"install":[{"cmd":"pip install md2cf","lang":"bash","label":"Install from PyPI"}],"dependencies":[],"imports":[{"note":"md2cf is a CLI tool, not a library. Use via command line.","symbol":"md2cf","correct":"import md2cf"}],"quickstart":{"code":"import os\nfrom md2cf import convert\n\n# Requires environment variables or config file\nresult = convert(\n    path='README.md',\n    space=os.environ.get('CONFLUENCE_SPACE', ''),\n    parent=os.environ.get('CONFLUENCE_PARENT', ''),\n    url=os.environ.get('CONFLUENCE_URL', ''),\n    username=os.environ.get('CONFLUENCE_USERNAME', ''),\n    token=os.environ.get('CONFLUENCE_TOKEN', '')\n)\nprint(result)","lang":"python","description":"Convert a Markdown file to Confluence using environment variables for authentication."},"warnings":[{"fix":"Replace `--bearer-token` with `--token` in CLI commands or scripts.","message":"In version 2.0.0, the CLI changed from `--bearer-token` to `--token`. Old scripts using `--bearer-token` will break.","severity":"breaking","affected_versions":">=2.0.0"},{"fix":"To avoid delays, ensure your network and Confluence API are stable. There is no configuration to disable retries.","message":"Automatic retries in v2.3.0 apply to all errors, not just HTTP 429. This can cause long delays on persistent failures.","severity":"gotcha","affected_versions":"2.3.0"},{"fix":"Pass `--no-ignore-gitignore` flag to include .gitignored files.","message":".gitignore is now used to skip files by default. If you want to include ignored files, use `--no-ignore-gitignore`.","severity":"gotcha","affected_versions":">=1.5.0"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Run `md2cf --help` from the terminal. If you need programmatic access, use subprocess to call the CLI.","cause":"md2cf is a CLI tool and its Python package might not expose a module named 'md2cf' directly. Use the command-line interface or install from source if you need the module.","error":"ModuleNotFoundError: No module named 'md2cf'"},{"fix":"Use the command line: `md2cf --space SPACE --url URL ... README.md`","cause":"The Python module does not expose a public API; md2cf is primarily a CLI tool.","error":"AttributeError: module 'md2cf' has no attribute 'convert'"},{"fix":"Replace `--bearer-token` with `--token`.","cause":"The `--bearer-token` flag was renamed to `--token` in version 2.0.0.","error":"Error: unrecognized arguments: --bearer-token"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}