Publish Markdown to Confluence
markfluence publishes and manipulates Confluence pages from Markdown files.
It needs a site URL, a username, and an API token, and for a scoped token a cloud ID: CONFLUENCE_URL, CONFLUENCE_USERNAME, CONFLUENCE_TOKEN, and CONFLUENCE_CLOUD_ID. markfluence reads each one from the first of these places that has it:
- the file that --env-file names
- the environment variable
- your credentials file, ~/.config/markfluence/credentials
The URL and the token must come from the same place, the cloud ID is read only from the place that gives the URL, and there is no flag for any of these. To set up the credentials file, run markfluence credentials-init, or see https://github.com/mozilla/markfluence/blob/main/docs/credentials.md
markfluence [flags]
-d, --debug Print debug details, such as each retry decision
--env-file string File to read credentials from, before the environment and your credentials file
-h, --help help for markfluence
--json Write JSON, and no human output. A result goes to stdout. A fatal error goes to stderr as a JSON error object
--no-color Print output with no color
--root string Documentation root for every file. The default is the nearest directory above each file that has a markfluence.yaml, or the directory of the file if there is none
- markfluence attachment-download - Download the attachments of a Confluence page
- markfluence attachment-list - List the attachments of a Confluence page
- markfluence attachment-upload - Upload or replace attachments on a Confluence page
- markfluence check - Check Markdown files for problems, with no network access
- markfluence children - List the pages and folders under a Confluence page, folder, or space
- markfluence create - Create new Confluence pages from Markdown files
- markfluence credentials-init - Write your credentials file, after checking the credentials
- markfluence diff - Show what is different between a page and its local Markdown file
- markfluence export - Write a Confluence page and its attachments to a directory
- markfluence find - Find Confluence pages and folders by their exact title
- markfluence page-info - Show the metadata of a Confluence page
- markfluence read - Get a Confluence page and print its body
- markfluence schema - Print the JSON Schema of the --json output
- markfluence search - Find Confluence pages by a search of their text
- markfluence space-info - Show the metadata of a Confluence space
- markfluence update - Publish one or more Markdown files to Confluence pages
- markfluence user-find - Find a user, and the Markdown that mentions them
- markfluence user-info - Show who the credentials belong to, or who an account id names