Markdown Math Renderer

Overview

You send Markdown with TeX math and we return sanitized HTML with every expression typeset as SVG. We pick up $...$ and \(...\) inline, $$...$$, \[...\] and ```math fences as display, and we deliberately leave math inside code spans and code fences alone. The result always goes through a safelist sanitizer, so scripts, event handlers and dangerous URLs never reach your page. We render and sanitize — we do not evaluate math, execute LaTeX, or generate PDFs. Do not use this for plotting, Mermaid diagrams, or solving expressions. Choosing between this and markdown.render: use this one when you need the expressions on their own as SVG fragments, the result written to a file, a malformed expression to fail the call rather than degrade to source, or more than 100 expressions in one pass. For rendering a document that merely contains math, markdown.render is the better choice — it typesets with this same engine when you set components.math.mode to auto, and it adds grammars, heading anchors, a table of contents, callouts, an image manifest and a sanitizer report that this skill does not have. Accepts file input via file_ref — no need to extract file content first.

Most downstream systems cannot render TeX natively — you need a deterministic, sanitized rendering layer.

When to use it

Scope

Non-goals

• Does not evaluate or solve math expressions
• Does not plot functions or generate charts
• Does not convert Markdown into LaTeX or PDF documents
• Does not execute arbitrary JavaScript or LaTeX

Properties

Capabilities

Cost & billing

Flat rate per invocation

File handling

File limits

Constraints this skill applies to your input and generated files. The “Limited by” column shows the static source of each cap; none of these can be raised by upgrading your plan.

How we handle your data

Input schema

Output schema

API contract

curl -sS -X POST "$BASE/v1/execute" -H "Authorization: Bearer $KEY" -H 'Content-Type: application/json' -d '{"skillKey":"markdown.render_math","input":{"markdown":"The formula is $x^2 + 1$."}}'

import { Squillify } from "@squillify/sdk";

const sq = new Squillify({ apiKey: process.env.SQUILLIFY_API_KEY });

const { output } = await sq.execute("markdown.render_math", {"markdown":"# Hello\n\nWorld","includeCss":false});

Errors

Other limits

Limitations

• Does not evaluate or solve math expressions
• Does not plot functions or generate charts
• Does not convert Markdown into LaTeX or PDF documents
• Does not execute arbitrary JavaScript or LaTeX
• Evaluating or solving mathematical expressions
• Generating PDF or standalone LaTeX documents
• Rendering Mermaid diagrams or data charts
• Rendering a Markdown document that happens to contain math — that is markdown.render, with components.math.mode set to auto

How to call

POST /v1/execute (requires authentication)

{
  "skillKey": "markdown.render_math",
  "input": {
    "markdown": "# Hello\n\nWorld",
    "includeCss": false
  }
}

Examples

{
  "markdown": "# Hello\n\nWorld",
  "includeCss": false
}

{
  "_meta": {
    "profile": "squillify-safe",
    "profileVersion": "1",
    "parser": "commonmark",
    "parserVersion": "0.24.0",
    "renderer": "mathjax",
    "rendererVersion": "4.1.2",
    "theme": "squillify",
    "themeVersion": "sqfy-markdown-v2",
    "cssIncluded": false,
    "inputChars": 14,
    "inputBytes": 14,
    "nodeCount": 4,
    "sanitized": true,
    "truncated": false
  },
  "format": "html_svg",
  "math": {
    "expressionCount": 0,
    "inlineCount": 0,
    "displayCount": 0,
    "numberedCount": 0,
    "warnings": []
  },
  "html": "<article class=\"sqfy-markdown sqfy-markdown-v2 sqfy-theme-squillify sqfy-markdown-math\"><h1>Hello</h1>\n<p>World</p></article>"
}

{
  "markdown": "Plain **bold** text.",
  "theme": "scientific-clean"
}

{
  "_meta": {
    "profile": "squillify-safe",
    "profileVersion": "1",
    "parser": "commonmark",
    "parserVersion": "0.24.0",
    "renderer": "mathjax",
    "rendererVersion": "4.1.2",
    "theme": "scientific-clean",
    "themeVersion": "legacy-math-v1",
    "cssIncluded": false,
    "inputChars": 20,
    "inputBytes": 20,
    "nodeCount": 5,
    "sanitized": true,
    "truncated": false
  },
  "format": "html_svg",
  "math": {
    "expressionCount": 0,
    "inlineCount": 0,
    "displayCount": 0,
    "numberedCount": 0,
    "warnings": []
  },
  "html": "<article class=\"sqfy-markdown-math sqfy-theme-scientific-clean\"><p>Plain <strong>bold</strong> text.</p></article>"
}

Recommended use cases

• Typeset a set of expressions into standalone SVG fragments, with no prose around them
• Render math-heavy content to a stored file instead of an inline response
• Typeset more expressions in a single pass than markdown.render accepts
• Fail a pipeline outright on a malformed expression rather than degrading to source

Avoid for

• Evaluating or solving mathematical expressions
• Generating PDF or standalone LaTeX documents
• Rendering Mermaid diagrams or data charts
• Rendering a Markdown document that happens to contain math — that is markdown.render, with components.math.mode set to auto

Related skills

Composable with

Safety & privacy

• Runs without calling any external service.
• Your payloads are never stored permanently.
• Telemetry captures metadata only — never your payload contents.
• We never train models on your payloads.
• No human reviews your payloads.

Tags