# comark

The comark skill parses markdown with Comark component support and renders it in Vue, React, Svelte or Angular. Fits projects with custom blocks in documentation or content.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 306 installs · ★ 730 repo stars
- Author: onmax
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/onmax/nuxt-skills/tree/HEAD/skills/comark/SKILL.md
- Updated: 2026-11-10
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/comark

## What it does

The skill teaches the agent to work with Comark, a markdown extension where you can embed components directly in text (`::alert{type="info"}` for blocks, `:icon` for inline). The parser is built on `markdown-it`, supports YAML frontmatter, automatic TOC generation, and syntax highlighting via Shiki. Rendering packages are `@comark/vue`, `@comark/react`, `@comark/svelte`, and `@comark/angular`.

The main method is `parseMarkdown()`, which returns AST, frontmatter, and metadata. There is streaming mode with auto-close for incomplete tags, suitable for on-the-fly content generation. Components can be mapped to custom ones: pass an object with names and get rendering with your own Vue or React components instead of default blocks.

Installation requires npm or pnpm. Documentation includes guides for syntax, parsing, and rendering for each framework.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add onmax/nuxt-skills --skill comark -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/comark/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/comark/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add onmax/nuxt-skills --skill comark -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/comark/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add onmax/nuxt-skills --skill comark -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/comark/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install onmax/nuxt-skills skills/comark
```

2. **Manually: put the files in place**
- File: `.github/skills/comark/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add onmax/nuxt-skills --skill comark -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/onmax/nuxt-skills --path skills/comark
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/comark/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add onmax/nuxt-skills --skill comark -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/onmax/nuxt-skills/tree/HEAD/skills/comark/SKILL.md

## When to use it
- parse markdown with custom components embedded in text
- render Comark documents in Vue, React, Svelte or Angular
- generate content in streaming mode with auto-close for tags
- extract YAML metadata and automatic TOC from markdown
- map blocks like `::alert` to your own project components

## Example prompts
- Parse markdown with frontmatter and output AST and metadata
- Create a Vue component that renders a Comark document with custom `::alert` and `::card` blocks
- Set up streaming markdown parsing for real-time content generation

## Similar
- [mapbox-web-integration-patterns](https://affpapa.org/en/nevibecode/skills/mapbox-web-integration-patterns.md) — skill · 2700 installs
- [markstream-install](https://affpapa.org/en/nevibecode/skills/markstream-install.md) — skill · 18 installs
- [ionic-framework-mcp](https://affpapa.org/en/nevibecode/skills/ionic-framework-mcp.md) — skill · 899 installs
- [formisch](https://affpapa.org/en/nevibecode/skills/formisch.md) — skill · 457 installs
- [tailwind-css-patterns](https://affpapa.org/en/nevibecode/skills/tailwind-css-patterns.md) — skill · 18100 installs
- [web-component-design](https://affpapa.org/en/nevibecode/skills/web-component-design.md) — skill · 13167 installs

From the same set: [onmax/nuxt-skills](https://affpapa.org/en/nevibecode/by/onmax/nuxt-skills.md) — 13 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
