Skip to content

Proof of concept project aimed at enabling the automatic synchronization of Markdown files with Confluence

License

Notifications You must be signed in to change notification settings

UlisesGascon/poc-sync-markdown-with-confluence

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

22 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

POC Synchronize Markdown files with Confluence

Proof of concept project aimed at enabling the automatic synchronization of Markdown files with Confluence

🔮 About

The poc-sync-markdown-with-confluence is a project or proof of concept (POC) that aims to synchronize markdown files with Jira Confluence

This POC explores the possibility of syncing markdown files stored in a version control system like Git with Confluence, with a simple automation managed with Github Actions. The motivation behind this project is to streamline the content creation process and make it easier for teams to collaborate on documentation. With the ability to sync markdown files with Confluence, teams can continue using their preferred text editor and version control system while seamlessly updating and publishing content on Confluence.

There are several benefits to synchronizing markdown files with Confluence. First and foremost, it allows teams to leverage the simplicity and flexibility of markdown for content creation. Markdown is easy to learn and write, making it accessible to everyone on the team. Additionally, since markdown files are plain text, they can be easily versioned, compared, and merged using Git or any other version control system.

More information

This project POC uses the following tools:

🧐 Demo

📺 Tutorial

Youtube Banner

📡 Usage

There are two pipelines in this project:

  • check-pr.yml checks every file with a markdown linter on every pull request made against main branch.
  • publish.yml same as check-pr.yml but also smart publishes the markdown files to Confluence.

⚙️ Customization

  1. Fork this repository
  2. Overwrite the pages folder content
  3. Update the file cosmere.json with your pages and baseUrl
  4. Add the following secrets to your repository CONFLUENCE_USERNAME and CONFLUENCE_PASSWORD.

Note:

  • CONFLUENCE_PASSWORD is yor API token, you can create one here.
  • CONFLUENCE_USERNAME is your email address.

About

Proof of concept project aimed at enabling the automatic synchronization of Markdown files with Confluence

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

 

Packages

No packages published