MarkdownInk
Terminal Markdown renderer · CLI + MCP

Markdown, rendered
beautifully in your terminal.

MarkdownInk turns Markdown into rich, syntax-highlighted terminal output — headings, code, tables, task lists, footnotes. Use it as the mdink CLI, or plug the same engine into any AI agent over MCP.

The idea

Your terminal prints Markdown as flat, gray text. mdink parses it with Markdig and paints it with Spectre.Console — the same bytes, finally readable.

notes.md · the source
# Welcome to mdink

This is a **terminal markdown
renderer** built with .NET 10.

## Features

- Syntax highlighting
- [x] Tables & task lists
- [ ] More themes

> Beautiful output, every time.

```csharp
var doc = Markdown.Parse(text);
renderer.Render(doc);
```
the terminal output
─── Welcome to mdink ────────
This is a terminal markdown renderer built with .NET 10.
Features
● Syntax highlighting
✔ Tables & task lists
☐ More themes
▍ Beautiful output, every time.
csharp
var doc = Markdown.Parse(text);
renderer.Render(doc);
The surface

Everything Markdown, in the terminal.

Full CommonMark plus the popular extensions, each rendered the way you'd expect it to look — nothing left as literal syntax.

Headings

H1/H2 as full-width rules, H3–H6 as colored text — a clear visual hierarchy in the terminal.

Syntax-highlighted code

30+ languages via TextMateSharp with VS Code’s Dark+ theme, in rounded panels with a language label.

Inline formatting

Bold, italic, strikethrough, and inline code — rendered, not left as literal Markdown syntax.

Clickable links

Real hyperlinks via OSC 8, so links are clickable in terminals that support it.

Tables

Rendered with rounded borders and per-column alignment — readable at a glance.

Lists & task lists

Ordered, unordered, nested, and task lists with real checkboxes.

Blockquotes

Nested block quotes with colored vertical bars that track the depth.

Footnotes

Numbered references collected into a dedicated footnotes section.

Thematic breaks

Horizontal rules that read as clean, full-width separators.

Syntax highlighting

30+ languages, VS Code's Dark+ theme.

Fenced code blocks are tokenized with real TextMate grammars via TextMateSharp and painted with the Dark+ theme — the same colors you see in your editor, now in your terminal.

C#JavaScriptTypeScriptPythonJSONXMLHTMLCSSYAMLBashSQLRustGoJavaRubyCC++PHPSwiftKotlinF#PowerShellMarkdownDockerfileMakefile& more
example.cs · csharp
// Rendered exactly like your editor
public static class Greeter {
  public static string Hello(string name) =>
      $"Hello, {name}!";
}
One engine, two ways to use it

A CLI for you. An MCP server for your agent.

The exact same renderer — pick the surface that fits.

CLImdink

Render a file or pipe from stdin, straight to your terminal.

shell
mdink README.md
cat notes.md | mdink
MCPMarkdownInk.Mcp

Two read-only tools — render_markdown and render_markdown_file — so an agent can show Markdown as rich terminal output instead of raw source.

mcp.json
{
  "mcpServers": {
    "markdownink": {
      "command": "dnx",
      "args": ["MarkdownInk.Mcp", "--yes"]
    }
  }
}
Install

Requires the .NET 10 SDK.

Pick how you want it on disk — the CLI and the MCP server share one codebase.

Install the mdink command globally as a .NET tool. Build the package from source, then install it:

shell
dotnet pack src/MarkdownInk -o nupkg
dotnet tool install -g --add-source nupkg MarkdownInk

Then run mdink <file.md> or cat notes.md | mdink.

MCP surface

Two tools. Read-only. Zero surprises.

Both return a uniform ToolResult envelope and never write to disk. Full reference →

render_markdownread

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.

markdown, ansi = true, width = 100
render_markdown_fileread

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.

path, ansi = true, width = 100