Automic VaultAutomic Vault

brew

Install mark with Homebrew, Nix

Sync your markdown files with Confluence pages. Version 16.5.0 via Homebrew; verified 2026-06-29.

Install commandSecurity notes

install

Additional install commands

macOS

Homebrewverified · 100%
brew install mark

local Homebrew formula metadata

Linux

Nixverified · 92%
nix profile install nixpkgs#mark

nixpkgs package indexes · pkgs/by-name/ma/mark/package.nix · source: api.github.com

overview

Package summary

Sync your markdown files with Confluence pages

Commands and aliases

  • mark

history

Project history and usage

Mark is a command-line publisher that synchronizes Markdown files from a repository or local workspace into Atlassian Confluence pages.

Project history

The project was created on GitHub in 2015. Its README frames the tool around a common engineering-docs problem: teams keep Markdown in Git but still need Confluence pages updated for an organization that uses Confluence as the visible documentation system.

Mark developed beyond simple Markdown conversion into a Confluence-specific publisher. The README documents page metadata comments, parent and folder creation, attachments, Confluence macros, GitHub-style alerts, task lists, Mermaid rendering, D2 rendering, PlantUML support, and preservation of inline comments.

Adoption history

Mark has a visible open-source user base, with the official repository showing more than a thousand stars and hundreds of forks. The supplied package facts show it packaged for Homebrew and Nix, and the README also documents Docker usage for CI or reproducible publishing jobs.

How it is used

Users run mark against one or more Markdown files and provide Confluence connection details by flags, environment variables, or a TOML config file. The CLI can create pages, update existing pages, upload attachments, translate Markdown to Confluence storage HTML, and optionally run in dry-run or compile-only modes.

Credentials are operationally important: the README documents username, password or token, base URL, and config-file options, and explicitly says credentials can be stored in the system-specific configuration file or supplied via CLI/environment variables.

Why package nerds care

Mark is significant as glueware: it lets teams keep docs reviewable in Git while publishing into a proprietary wiki. For package maintainers, it is a single binary CLI with CI-friendly flags and a clear target audience, rather than another general Markdown renderer.

Timeline

  • 2015: GitHub repository created.
  • 2026: Repository metadata shows ongoing activity and a large issue/PR history.
  • 2026: Supplied package facts list Homebrew and Nix packaging.

Related projects

  • Mark sits between Markdown tooling and Atlassian Confluence's REST/storage APIs.
  • Its README references optional rendering integrations such as Mermaid, D2, PlantUML, and GitHub-style Markdown alerts.

security posture

No protected-tool coverage found yet

No matching local secret-handling manifest was found for mark. Nucleus package metadata is still published here so future coverage has a stable package URL.

Install behavior

  • No Homebrew post-install hook is recorded in formula metadata.
  • Homebrew bottle metadata is available for 6 platform targets.
  • Build metadata lists 1 build dependencies.

Recommended review

Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.

local files

Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.

Configuration files

Config paths the tool may read or write during local use.

Linux
$XDG_CONFIG_HOME/mark.toml~/.config/mark.toml
macOS
~/Library/Application Support/mark.toml
Windows
%AppData%\mark.toml

Credential files

Credential-bearing paths to review before unattended agent runs.

Linux
$XDG_CONFIG_HOME/mark.toml~/.config/mark.toml
macOS
~/Library/Application Support/mark.toml
Windows
%AppData%\mark.toml

executables

Installed executables

CommandKindExposureNote
markcliglobal executable

freshness

Version and freshness

These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.

page generated2026-07-08
manager version16.5.0
manager updated2026-06-29
local dataok
upstreamcurrent
latest detectedv16.5.0

https://github.com/kovetskiy/mark

  • okNo freshness warnings were generated.

install metadata

Package metadata

Package keybrew:mark
Version16.5.0
Package managerHomebrew
Package manager pagehttps://formulae.brew.sh/formula/mark
Homepagehttps://samizdat.dev
Repositoryhttps://github.com/kovetskiy/mark
Upstream docshttps://github.com/kovetskiy/mark#readme
LicenseApache-2.0
Source archivehttps://github.com/kovetskiy/mark/archive/refs/tags/v16.5.0.tar.gz
Last updated2026-06-29T21:16:49Z
Pulseupdated
Build dependenciesgo
Bottleavailable (on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux)
Homebrew post-installnot defined
Servicenone declared

registry facts

Source database details

Source DatabaseHomebrew formula API
Taphomebrew/core
Full Namemark
Version Scheme0
Revision0
Head VersionHEAD
Bottle Stable Root URLhttps://ghcr.io/v2/homebrew/core
Deprecatedno
Disabledno
Keg Onlyno
URL Keys
  • head
  • stable

source database matches

Other package-manager records

Matches are pulled from external package-manager indexes and kept separate from local Automic Vault package links.

Nix95%

mark

nix profile install nixpkgs#mark
  • normalized package name match
  • Matched by: Mark
nixpkgs package indexes · api.github.com · nixpkgs package indexes: pkgs/by-name/ma/mark/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

package graph

Links come from deterministic package relationships, av.db category and tag curation, ecosystem matches, and package hub membership.

Related tools

  • goBuild dependency declared by Homebrew.

Same workflow

  • markdown-tocShares av.db curated category or tags: cli, documentation, markdown, productivity.
  • asciidocShares av.db curated category or tags: cli, documentation, productivity.
  • joplin-cliShares av.db curated category or tags: cli, markdown, productivity, sync.
  • backlog-mdShares av.db curated category or tags: cli, markdown, productivity.
  • bullettyShares av.db curated category or tags: cli, markdown, productivity.
  • deckShares av.db curated category or tags: cli, markdown, productivity.

source trail

Generated from repository data

This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.

Used sources

  • Geiger risk classifier
  • Nucleus package database
  • av.db category and tag curation
  • cross-ecosystem install command graph
  • curated configuration and credential file locations
  • curated package history
  • external package-manager database matches
  • package relationship graph
  • package version freshness
  • package-page enrichment