# kovetskiy/mark

Sync your markdown files with Confluence pages.

Repository: https://github.com/kovetskiy/mark
Canonical: https://ross.abutalabs.com/products/mark
Homepage: https://samizdat.dev
Language: Go
License: Apache-2.0
License Family: permissive
Topics: confluence, git, markdown
Last push: 2026-08-23T19:06:40+00:00

## Health v2 (maintenance only)
Score: 99/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 98, longevity 100
- inputs: {"age_days": 4001, "days_push": 10, "days_rel": 14, "gap_med": 4.0, "n_releases_24m": 57}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1555, forks 228 (observed 2026-08-28T04:05:03.139817+00:00)

## What it is
Mark is a Go CLI tool that syncs markdown files with Atlassian Confluence pages via the REST API. It reads markdown with metadata headers or YAML front matter, creates or updates pages, uploads attachments, and translates markdown to Confluence-compatible HTML.

## Use cases
- sync markdown docs from a git repo to confluence
- publish readme files to confluence pages automatically
- avoid using the confluence wysiwyg editor
- keep confluence documentation in version control
- create confluence page hierarchies from markdown headers
- upload attachments and labels to confluence via cli
- ci/cd pipeline to update confluence on push

## When to choose
- your team stores documentation in git but stakeholders read it in Confluence
- you want docs-as-code with Confluence as the publishing target
- you need automated, repeatable Confluence page updates from CI

## When to avoid
- you don't use Atlassian Confluence
- you want a static site generator instead of a wiki
- you need rich Confluence macros beyond what markdown translation supports

## Facets
- artifact type: cli-tool
- maturity: active
- function: markdown, documentation, cli, templating
- domain: documentation, developer-tools
- platform: cli, windows, cross-platform
- tags: confluence, markdown-sync, git-workflow, docs-as-code, command-line, automation, linux, macos

## Member repositories
- kovetskiy/mark (main) score 99

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:03.139817+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:30:02.126023+00:00, confidence not recorded.
  - readme: https://github.com/kovetskiy/mark (fetched 2026-08-28T04:05:03.139817+00:00, sha fc4bfd7775ba)
- Data as of 2026-08-30T08:39:29.467469+00:00.