# Markdown Documents

Write or edit Markdown notes, reports and plain text; default for non-Office writing.

- Repository: https://github.com/agent0ai/agent-zero (19630 stars)
- Category: Writing
- License: see repository
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add agent0ai/agent-zero --skill markdown-documents -g -a claude-code -y`
Codex: `npx skills add agent0ai/agent-zero --skill markdown-documents -g -a codex -y`
Cursor: `npx skills add agent0ai/agent-zero --skill markdown-documents -g -a cursor -y`
Gemini CLI: `npx skills add agent0ai/agent-zero --skill markdown-documents -g -a gemini-cli -y`

## Description

Write or edit Markdown notes, reports and plain text; default for non-Office writing.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Markdown Documents

Markdown is the default document format for normal writing, notes, reports, briefs, drafts, and collaborative text work unless the user explicitly asks for a binary office file. When they do ask for a LibreOffice office file, prefer ODF: ODT for Writer, ODS for Spreadsheet/Calc, and ODP for Presentation/Impress. Use DOCX, XLSX, or PPTX only for explicit OOXML compatibility.

The Editor surface is user-owned UI. Create or update the saved Markdown file, but never open the Editor automatically. Set `open_in_canvas: true` only when the user explicitly asks to open the canvas/Editor; otherwise already-open Editor sessions refresh automatically. Keep the final response to the saved/updated result and path; do not write faux UI action labels such as "Open document" or "Download file", and do not add a note saying the canvas was not opened automatically unless the user explicitly asks about UI behavior.

## Workflow

1. Decide whether a saved editable artifact is useful. Create one for substantial, reusable, or collaborative writing; do not create one for tiny one-shot edits or answers that can be completed cleanly in chat.
2. Create Markdown with `text_editor` using `action: "write"` and an explicit `.md` path.
3. For edits to an existing Markdown file, read first when content matters, then use `patch` for targeted changes or `write` for deliberate full replacement.
4. Report the saved file path briefly. Do not say it was opened unless the user explicitly opened it.

Minimal create:

```json
{
  "tool_name": "text_editor",
  "tool_args": {
    "action": "write",
    "path": "/a0/usr/workdir/Project Brief.md",
    "content": "# Project Brief\n\nDraft text here."
  }
}
```

Practical rules:

The rest: https://github.com/agent0ai/agent-zero/blob/HEAD/plugins/_office/skills/markdown-documents/SKILL.md