MarkdownInk
Reference

Two tools

MarkdownInk.Mcp is a stdio MCP server that renders Markdown to terminal-ready output — the same engine as the mdink CLI. Both tools are read-only; wire names are snake_case.

ANSI by default. Both tools return ANSI-colored output. Pass ansi: false for the same layout as plain text with no color escape codes, and width (default 100) to control wrapping and table sizing. render_markdown_file reads the file but never modifies it.

Response envelope

ToolResult<T>

Every tool returns a uniform, typed envelope. The returns shown on each card below is the shape of data — the payload — not the whole envelope.

ok{ "ok": true, "data": { "output", "ansi", "width", "lineCount", "path"? } }
err{ "ok": false, "error": { "type", "message", "hint"?, "correlationId" } }

Tools set UseStructuredContent, so data is also delivered as MCP structuredContent alongside an advertised outputSchema. Validation and not-found failures are reported in-band (ok: false) with a stable error.type.

Rendering

Markdown in, terminal-ready output out. Read-only.
Render Markdown

Render a Markdown string to beautiful, terminal-ready output — headings, syntax-highlighted code blocks, tables, lists, task lists, block quotes, footnotes, and clickable links. Read-only: operates purely on the provided string and never touches the filesystem.

params
markdown, ansi = true, width = 100
returns
output (the rendered text — ANSI escape codes when ansi:true), ansi, width, lineCount
Render Markdown File

Read a Markdown file from disk and render it to beautiful, terminal-ready output — the same rich formatting as render_markdown. Read-only: reads the file but never modifies it.

params
path, ansi = true, width = 100
returns
output, ansi, width, lineCount, path
Get started

Add it to your client

Point any MCP client at the server via dnx — see the install options →