How do I install the Markvis skill?

Run npx skillmds@latest add geekplux/markvis in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Markvis safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Markvis?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Markvis free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Markvis?

geekplux (@geekplux) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Markvis by geekplux — Agent Skill

Name: Markvis
Rating: 4.666666666666667 (3 reviews)
Author: geekplux

Markvis

Use when the user wants a chart of numbers in Markdown (bar, line, area, scatter, pie, hist) from a table — emit a Markdown code block tagged chart|markvis|vis, never a flowchart pie/xychart, never a PNG, never Vega-Lite JSON as the default.

geekplux Updated Sep 22, 2026

File contents

markvis

Charts of numbers in Markdown. The table is the source (comma-separated rows or a Markdown table). Tags chart, markvis, and vis are the same language. Types: bar line area scatter pie hist only.

When to use

Numbers in a doc need a chart and the rows must stay editable.
An agent should be able to add a row, change type, and regenerate.
Readers without a plugin still need the table.

When not to use

Flowcharts, sequence, state, ER → a structure diagram tool.
Invented PNG / screenshot as the source of truth.
Vega-Lite / ECharts JSON as the default artifact (optional later engine:, not core).
A 7th chart type (donut, heatmap, stacked-bar as its own type).

Fence shape

```chart
markvis: 2
type: bar
title: Q3 Revenue
unit: USD k
x: month
y: revenue

month,revenue
Jan,120
Feb,180
Mar,150


Optional `theme:`: `folio` (default) `highcharts` `shadcn` `docs` `ant` `recharts` — grammar packs only, no chart runtimes.
Optional `palette:`: `ink` `porcelain` `warm` `cool` `vivid` — colors only. Omit → theme default colors. Unknown → `E_UNKNOWN_PALETTE` + table. Never merge palette into the theme id.

Also: GFM table after the blank line; or `<!-- chart: bar x=month y=revenue title="Q3" -->` immediately followed by a GFM table.

## Eight few-shots

Copy from `examples/valid/` (keep fences identical):

1. `01-bar-basic` — bar + unit + CSV  
2. `02-line-multi` — line + `series`  
3. `03-area-basic` — area, tag `vis`  
4. `04-scatter-basic` — scatter  
5. `05-pie-raw` — pie (do not normalize; 40+35+30)  
6. `06-hist-basic` — hist  
7. `07-bar-gfm` — GFM table as data  
8. `08-bar-comment` — HTML comment + table  

## Anti-patterns

| Don’t | Do |
| --- | --- |
| Flowchart `pie` / `xychart` for tables | markvis fence |
| JSON array as the data body | CSV or GFM table |
| Sort categories “to look nice” | Keep input row order |
| Force pie slices to 100 | Leave values as-is |
| Drop the table on error | Table + one-line error code |
| Emit PNG by default | Emit the fence |

---name: markvisdescription: Use when the user wants a chart of numbers in Markdown (bar, line, area, scatter, pie, hist) from a table — emit a Markdown code block tagged chart|markvis|vis, never a flowchart pie/xychart, never a PNG, never Vega-Lite JSON as the default.---# markvisCharts of numbers in Markdown. The table is the source (comma-separated rows or a Markdown table). Tags `chart`, `markvis`, and `vis` are the same language. Types: `bar` `line` `area` `scatter` `pie` `hist` only.## When to use- Numbers in a doc need a chart and the rows must stay editable.- An agent should be able to add a row, change `type`, and regenerate.- Readers without a plugin still need the table.## When not to use- Flowcharts, sequence, state, ER → a structure diagram tool.- Invented PNG / screenshot as the source of truth.- Vega-Lite / ECharts JSON as the default artifact (optional later `engine:`, not core).- A 7th chart type (`donut`, `heatmap`, `stacked-bar` as its own type).## Fence shape``````chartmarkvis: 2type: bartitle: Q3 Revenueunit: USD kx: monthy: revenuemonth,revenueJan,120Feb,180Mar,150``````Optional `theme:`: `folio` (default) `highcharts` `shadcn` `docs` `ant` `recharts` — grammar packs only, no chart runtimes.Optional `palette:`: `ink` `porcelain` `warm` `cool` `vivid` — colors only. Omit → theme default colors. Unknown → `E_UNKNOWN_PALETTE` + table. Never merge palette into the theme id.Also: GFM table after the blank line; or `` immediately followed by a GFM table.## Eight few-shotsCopy from `examples/valid/` (keep fences identical):1. `01-bar-basic` — bar + unit + CSV 2. `02-line-multi` — line + `series` 3. `03-area-basic` — area, tag `vis` 4. `04-scatter-basic` — scatter 5. `05-pie-raw` — pie (do not normalize; 40+35+30) 6. `06-hist-basic` — hist 7. `07-bar-gfm` — GFM table as data 8. `08-bar-comment` — HTML comment + table ## Anti-patterns| Don’t | Do || --- | --- || Flowchart `pie` / `xychart` for tables | markvis fence || JSON array as the data body | CSV or GFM table || Sort categories “to look nice” | Keep input row order || Force pie slices to 100 | Leave values as-is || Drop the table on error | Table + one-line error code || Emit PNG by default | Emit the fence |

Frequently asked questions