Markdown-to-Corporate Knowledge Base Synchronizer (CLI)
Streamline your enterprise documentation pipeline by converting local markdown structures into native corporate knowledge base entries without the formatting headaches.
The Problem
Technical writers and developers keep their documentation clean and version-controlled in local Markdown folders. However, syncing those docs to enterprise tools like Confluence or Notion involves breaking tables, losing image links, and fixing broken formatting manually.
The Solution
This robust CLI utility utilizes an Abstract Syntax Tree (AST) parser to translate standard Markdown blocks into corporate API schemas, handles localized asset uploads natively, and updates page parenting dynamically to match your folder structures.
Key Features
- Smart AST Parsing: Translates Markdown blocks (including tables, code blocks, and callouts) directly into Confluence Storage Format (XHTML) or Notion Block components.
- Asset Upload Automation: Detects local image paths, uploads them to the target platform, and updates the references in the published page automatically.
- Dynamic Hierarchy Control: Mirror your local folder nested structures directly into the remote platform’s parent/child page relationships.
- Dry Run Support: Test your schema conversions locally before pushing updates to your live corporate instances.
Quick Start
Installation
Set up your environment using the native script for your operating system inside the `scripts/` directory:
- MacOS/Linux: `bash scripts/setup.sh`
- Windows: Run `scripts/setup.ps1` in PowerShell
Configuration
Create a `.env` file in the project root:
“`env
CONFLUENCE_URL=[https://your-domain.atlassian.net/wiki](https://your-domain.atlassian.net/wiki)
CONFLUENCE_USER=your-email@company.com
CONFLUENCE_TOKEN=your-api-token
NOTION_TOKEN=secret_yournotiontoken
“`
### Usage Examples
Validate markdown structure without uploading (Dry Run):
“`bash
python -m src.cli –source ./docs –target confluence –dry-run
“`
Sync documentation directory to Confluence:
“`bash
python -m src.cli –source ./docs –target confluence –space DS –parent-id 12345
“`
$119.00Add to cart