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.
Your terminal prints Markdown as flat, gray text. mdink parses it with Markdig and paints it with Spectre.Console — the same bytes, finally readable.
# 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); ```
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.
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.
// Rendered exactly like your editor
public static class Greeter {
public static string Hello(string name) =>
$"Hello, {name}!";
}A CLI for you. An MCP server for your agent.
The exact same renderer — pick the surface that fits.
mdinkRender a file or pipe from stdin, straight to your terminal.
mdink README.md
cat notes.md | mdinkMarkdownInk.McpTwo read-only tools — render_markdown and render_markdown_file — so an agent can show Markdown as rich terminal output instead of raw source.
{
"mcpServers": {
"markdownink": {
"command": "dnx",
"args": ["MarkdownInk.Mcp", "--yes"]
}
}
}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:
dotnet pack src/MarkdownInk -o nupkg
dotnet tool install -g --add-source nupkg MarkdownInkThen run mdink <file.md> or cat notes.md | mdink.
Any MCP client that speaks dnx (the .NET npx) runs the server on demand — no install step. Add to your client config:
{
"mcpServers": {
"markdownink": {
"command": "dnx",
"args": ["MarkdownInk.Mcp", "--yes"]
}
}
}dnx fetches and caches the MarkdownInk.Mcp package on first use.
Build the image from the repo's Dockerfile and run it — the server speaks stdio.
docker build -t markdownink-mcp .
docker run -i --rm markdownink-mcpThe -i flag is required for stdio transport.
Clone and run either surface straight from the checkout:
git clone https://github.com/Atypical-Consulting/MarkdownInk
cd MarkdownInk
dotnet run --project src/MarkdownInk -- README.md # CLI: render a file
dotnet run --project src/MarkdownInk.Mcp # MCP server (stdio)Two tools. Read-only. Zero surprises.
Both return a uniform ToolResult envelope and never write to disk. Full reference →
render_markdownreadRender 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.
render_markdown_filereadRead 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.