Docs

Quickstart for a developer in a hurry. No marketing yoga. Just clicks and outcomes.

1) Open the app

Open ZenMark. No account required. Your notes stay local by default.

2) Create an artefact (Spec / ADR / Debug)

Spec

Use a template (or start empty), write in Markdown, and keep it reviewable.

---
type: spec
title: "Feature: Local semantic search"
status: draft
---

## Goal

## Non-goals

## Approach

## Acceptance criteria

ADR

Document decisions so Future You stops hating Past You.

---
type: adr
title: "Use OpenRouter as the only AI provider"
status: accepted
---

## Context

## Decision

## Consequences

3) Add tags and organize

Create folders. Add tags. Search. Keep it boring and effective.

TipUse tags like #bug, #design, #infra, #prompt to slice your knowledge quickly.

4) Use AI Suggest on a note (preview-first)

AI is a tool: it runs only when you click. ZenMark asks for a structured output you can review and apply partially.

What you get

A suggestion payload (title, summary, tags, type). You choose what to apply.

Example output

{
  "type": "debug",
  "title": "Fix: Ghost Markdown renderer breaks on smart quotes",
  "summary": "Root cause: HTML sanitizer strips code fences when quotes are normalized. Mitigation: normalize punctuation before export.",
  "tags": ["ghost", "markdown", "export", "bug"]
}

5) Use AI on a selection (preview, then apply)

Select text and run an action: rewrite, expand, translate, explain. Then choose:

6) Export Markdown

Export your note as Markdown (frontmatter optional). Keep your data portable.

Security & privacy

Ready?
Open the app and create your first artefact.