https://github.com/servian/confluence-pusher

A tool to convert and upload markdown documents into Atlassian Confluence
https://github.com/servian/confluence-pusher

batch-processing confluence confluence-markup markdown

Last synced: 3 months ago
JSON representation

A tool to convert and upload markdown documents into Atlassian Confluence

• Host: GitHub
• URL: https://github.com/servian/confluence-pusher
• Owner: servian
• License: mit
• Created: 2020-01-14T23:12:48.000Z (almost 5 years ago)
• Default Branch: master
• Last Pushed: 2020-03-19T00:36:56.000Z (over 4 years ago)
• Last Synced: 2024-07-11T17:33:09.282Z (4 months ago)
• Topics: batch-processing, confluence, confluence-markup, markdown
• Language: Lua
• Size: 11.5 MB
• Stars: 4
• Watchers: 9
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# confluence-pusher

A tool to convert and upload markdown documents into Atlassian Confluence using the [Atlassian Python API](https://atlassian-python-api.readthedocs.io/en/latest/index.html).

---

## How it works

### File conversion

> **Warning:** Confluence can't create two documents with the same name in the same space, for example: folder /Build and file named build.md

The source folder is traversed for markdown files. The folder and document structures are replicated in Confluence. The document conversion is performed using Pandoc with the [pandoc-confluence-writer](https://github.com/jpbarrette/pandoc-confluence-writer/blob/master/confluence.lua) custom filter:

| Local         | Confluence                   |

| :------------ | :--------------------------- |

| Root Folder   | Root Document                |

| README.md     | Root Document Content        |

| others.md     | Sub-Page under Root Document |

| Sub-Directory | Section Document             |

The document names are renamed to reflect the H1 markdown header if available.

---

## Before you begin

Configure Confluence API

- 

-