Command-line use

confluence.md allows you to push any markdown file to Confluence. You can create a new page (under given parent) or update an existing one.

Instructions

Example workflow:

1. Create page

Create a new page under --parent_id:

$ confluence.md --user user@name.net \             # Atlassian username
        --token 9a8dsadsh \                        # API token or --password
        --url https://your-domain.atlassian.net \  # Confluence instance URL
        create \                                   # create or update
        --file README.md \                         # markdown file
        --parent_id 182371 \                       # parent page
        --title "new title"                        # title for a new page
        --add_meta                                 # adds meta to source.md file

2. Verify markdown

The page is created and the file is decorated with metadata:

$ head -n 3 markdown.md
---
confluence-url: https://your-domain.atlassian.net/wiki/spaces/SP/pages/18237182/new+title
---

3. Update page

Performing an update does not require providing --page_id and --url:

$ confluence.md --user user@name.net --token 9a8dsadsh update --file README.md

Doing an update with --page_id and --url is still possible.

Consider adding useful --add_info option.

To create Atlassian API Token go to api-tokens.

Command line arguments

Actions:

update Updates page content based on given page_id or metadata in Markdown file
create Creates new page under given parent_id

positional arguments:

{update,create} Action to run

optional arguments:

-h, --help show this help message and exit
--file FILE input markdown file to process
--add_meta adds metadata to .md file for easy editing
--add_info adds info panel automatic content do not edit on top of the page
--add_label ADD_LABEL adds label to page
--convert_jira convert all Jira links to issue snippets (either short [KEY-ID] format or full URL) note: this options works only in Cloud instances with Smart Issue for Confluence installed
-v, --verbose verbose mode
-q, --quiet quiet mode

required auth parameters:

-u USER, --user USER Atlassian username/email
-t TOKEN, --token TOKEN Atlassian API token
-p PWD, --password PWD Atlassian password (used in on-prem instances)
-l URL, --url URL Atlassian instance URL
-n, --no_verify_ssl don't verify SSL cert (useful in on-prem instances)

create page parameters:

--parent_id PARENT_ID define parent page id while creating a new page
--title TITLE define page title while creating a new page
--overwrite force overwrite if page with this title already exists

update page arguments:

--page_id PAGE_ID define (or override) page id while updating a page

Secure Markdown for Confluence