md2cf
Convert Markdown documents to Confluence
Decision gist · record as of 2026-08-14
Yes, if you need to automate Markdown-to-Confluence publishing and accept dormant maintenance. The tool is stable and has no known vulnerabilities, but expect no active development—use it for straightforward conversion and upload workflows, not as a foundation for custom extensions. For active support or cutting-edge Confluence API features, consider alternatives under active maintenance.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.7 or later.
- Confluence instance URL and valid credentials (username/password or personal access token) are mandatory; token behavior differs between Confluence Cloud and self-hosted instances.
- Low install friction with a pure-Python wheel distribution.
License · maintenance · safety
MIT (permissive) — MIT license (permissive) allows unrestricted use, modification, and distribution with minimal legal friction.
last release 2023-08-06 (1104 days) · last repo commit 2024-05-21 · 124 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 77,898 downloads/mo, #14,482 on PyPI
Alternatives
Verify before relying
pip install md2cf
md2cf --host 'https://confluence.example.com/rest/api' --username foo --password bar --space TEST document.md- Whether the embedded Confluence REST API implementation covers all required operations for your use case beyond basic page creation and updates.
- Current compatibility with recent Confluence Server and Cloud API versions, given dormant maintenance status since mid-2024.
What it is and what it does
md2cf is a command-line tool and Python library that bridges Markdown and Confluence by converting Markdown documents into Confluence Storage Format and uploading them directly to a Confluence instance. It wraps a Mistune-based renderer to handle the Markdown-to-Storage conversion and includes a lightweight REST API client for Confluence Server operations. The tool is designed for automation workflows where you want to publish or mirror Markdown documentation to Confluence without manual page creation.
You provide a Confluence host URL, authentication credentials (username/password or personal access token), a target space, and one or more Markdown files. md2cf handles the conversion, uploads pages, manages attachments, and supports batch operations on folders. It can read from files, directories, or stdin, and offers options to strip headers, add prefaces, manage labels, set parent pages, and detect unchanged content to avoid redundant updates.
Use it for
- Automate publishing of Markdown-based documentation (e.g., from a Git repo) to a Confluence space on a schedule.
- Mirror technical documentation written in Markdown to Confluence for team access without manual conversion.
- Batch-upload multiple Markdown files or an entire documentation folder to Confluence with consistent formatting.
- Integrate Markdown documentation into CI/CD pipelines to keep Confluence pages in sync with source control.
- Convert and upload Markdown with front-matter metadata (title, labels) to control page properties in Confluence.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you need to automate Markdown-to-Confluence publishing and accept dormant maintenance.
The tool is stable and has no known vulnerabilities, but expect no active development—use it for straightforward conversion and upload workflows, not as a foundation for custom extensions. For active support or cutting-edge Confluence API features, consider alternatives under active maintenance.
Install
md2cf on PyPI
Before you install
Low install friction with a pure-Python wheel distribution. Maintenance is dormant—last release was 2023-08-06 and last commit 2024-05-21, over a year ago—so expect no active bug fixes or feature updates, though the codebase remains stable for its current scope.
Requires Python 3.7 or later. Confluence instance URL and valid credentials (username/password or personal access token) are mandatory; token behavior differs between Confluence Cloud and self-hosted instances.
License in practice
MIT license (permissive) allows unrestricted use, modification, and distribution with minimal legal friction.
Quickstart
pip install md2cf
md2cf --host 'https://confluence.example.com/rest/api' --username foo --password bar --space TEST document.mdVerify before relying
- Whether the embedded Confluence REST API implementation covers all required operations for your use case beyond basic page creation and updates.
- Current compatibility with recent Confluence Server and Cloud API versions, given dormant maintenance status since mid-2024.
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release >=3.7 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 7 packagesrich-argparserichmistunechardetrequestsPyYAMLgitignorefile |
| Maintenance | Dormant 1,104 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 77,898 / month, #14,482 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | License :: OSI Approved :: MIT LicenseOperating System :: OS IndependentProgramming Language :: Python :: 3 |
Evidence: md2cf-2.3.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “confluence upload tool”
- md2cfConverts Markdown documents to Confluence Storage Format and uploads…
- markdown-to-confluenceConverts Markdown files to Confluence Storage Format and publishes…
- atlas-doc-parserConverts Atlassian Document Format (ADF) JSON from Confluence and…
Give your agent the search over MCP, or paste the wish link into any chat.
More Markup packages
PyYAML parses and emits YAML 1.1 data format, enabling serialization and deserialization of configuration files and Python objects to and from human-readable YAML text.
A Python markdown parser that converts markdown to HTML following the CommonMark specification, with support for plugins and custom syntax rules.
Install it if you need reliable markdown-to-HTML conversion.
Beautiful Soup parses HTML and XML documents into a navigable tree, providing Pythonic methods to search, iterate, and modify the parsed content.
Install it if you need to parse or extract data from markup documents.
et_xmlfile writes large XML files with minimal memory overhead by serializing elements to disk as they are created, rather than holding the entire tree in memory.
Install it if incremental XML writing fits your use case; skip it if your XML documents are small or you already use lxml.
Parses and edits TOML files while preserving formatting, comments, and structure, then serializes them back with layout intact.
Install it if you're building tools that touch TOML files and user readability of the source matters.
Parses Python docstrings in ReST, Google, Numpydoc, and Epydoc formats, extracting structured information like descriptions, parameters, return types, and exceptions.
Install it if you need to programmatically read and extract structured data from Python docstrings.
See also markdown-to-confluence · atlas-doc-parser · atlassian-doc-builder · sphinxcontrib-confluencebuilder · sphinx_mdinclude · m2r2 · llama-index-readers-confluence · mdformat_myst · markdown2 · markitdown