md2cf

library2.3.0pypypi✓ verified 84d ago

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.

communication serialization

pip install md2cf

github ↗package ↗

INSTALL

IMPORT

SIG · MD2CF

md2cf

communicationpythonv2.3.0

Install

5.7s avg

Import

—

Disk

36MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v2.3.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.000s · 37.3MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 5.7s · import 0.000s · 38MB

36MB installed

● package 36MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

md2cf

✓ import md2cf

md2cf is a CLI tool, not a library. Use via command line.

Convert a Markdown file to Confluence using environment variables for authentication.

import os from md2cf import convert # Requires environment variables or config file result = convert( path='README.md', space=os.environ.get('CONFLUENCE_SPACE', ''), parent=os.environ.get('CONFLUENCE_PARENT', ''), url=os.environ.get('CONFLUENCE_URL', ''), username=os.environ.get('CONFLUENCE_USERNAME', ''), token=os.environ.get('CONFLUENCE_TOKEN', '') ) print(result)

md2cf --version

Debug

Known issues

breakingIn version 2.0.0, the CLI changed from `--bearer-token` to `--token`. Old scripts using `--bearer-token` will break.

fix

Replace `--bearer-token` with `--token` in CLI commands or scripts.

affects: >=2.0.0

gotchaAutomatic retries in v2.3.0 apply to all errors, not just HTTP 429. This can cause long delays on persistent failures.

fix

To avoid delays, ensure your network and Confluence API are stable. There is no configuration to disable retries.

affects: 2.3.0

gotcha.gitignore is now used to skip files by default. If you want to include ignored files, use `--no-ignore-gitignore`.

fix

Pass `--no-ignore-gitignore` flag to include .gitignored files.

affects: >=1.5.0

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'md2cf'

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.

fix

Run `md2cf --help` from the terminal. If you need programmatic access, use subprocess to call the CLI.

AttributeError: module 'md2cf' has no attribute 'convert'

The Python module does not expose a public API; md2cf is primarily a CLI tool.

fix

Use the command line: `md2cf --space SPACE --url URL ... README.md`

Error: unrecognized arguments: --bearer-token

The `--bearer-token` flag was renamed to `--token` in version 2.0.0.

fix

Replace `--bearer-token` with `--token`.

Upgrade

Version history

2.3.0latest on PyPI · released Aug 6, 2023

Audit

Dependencies

No dependency data recorded yet.

Agent activity

34 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/iamjackg/md2cf ↗

packagehttps://pypi.org/project/md2cf/ ↗