From c538c151c7462ad0395ff2c15c5e11e89e362aa8 Mon Sep 17 00:00:00 2001
From: Striven <sg.striven@cutecat.club>
Date: Sat, 04 Apr 2026 19:47:16 +0000
Subject: [PATCH] Initial commit
---
quartz/plugins/transformers/latex.ts | 79 +++++++++++++++++++++++++++------------
1 files changed, 55 insertions(+), 24 deletions(-)
diff --git a/quartz/plugins/transformers/latex.ts b/quartz/plugins/transformers/latex.ts
index 5c6f767..a9f54f3 100644
--- a/quartz/plugins/transformers/latex.ts
+++ b/quartz/plugins/transformers/latex.ts
@@ -1,44 +1,75 @@
import remarkMath from "remark-math"
import rehypeKatex from "rehype-katex"
-import rehypeMathjax from "rehype-mathjax/svg.js"
+import rehypeMathjax from "rehype-mathjax/svg"
+//@ts-ignore
+import rehypeTypst from "@myriaddreamin/rehype-typst"
import { QuartzTransformerPlugin } from "../types"
+import { KatexOptions } from "katex"
+import { Options as MathjaxOptions } from "rehype-mathjax/svg"
+//@ts-ignore
+import { Options as TypstOptions } from "@myriaddreamin/rehype-typst"
interface Options {
- renderEngine: "katex" | "mathjax"
+ renderEngine: "katex" | "mathjax" | "typst"
+ customMacros: MacroType
+ katexOptions: Omit<KatexOptions, "macros" | "output">
+ mathJaxOptions: Omit<MathjaxOptions, "macros">
+ typstOptions: TypstOptions
}
-export const Latex: QuartzTransformerPlugin<Options> = (opts?: Options) => {
+// mathjax macros
+export type Args = boolean | number | string | null
+interface MacroType {
+ [key: string]: string | Args[]
+}
+
+export const Latex: QuartzTransformerPlugin<Partial<Options>> = (opts) => {
const engine = opts?.renderEngine ?? "katex"
+ const macros = opts?.customMacros ?? {}
return {
name: "Latex",
markdownPlugins() {
return [remarkMath]
},
htmlPlugins() {
- if (engine === "katex") {
- return [[rehypeKatex, { output: "html" }]]
- } else {
- return [rehypeMathjax]
+ switch (engine) {
+ case "katex": {
+ return [[rehypeKatex, { output: "html", macros, ...(opts?.katexOptions ?? {}) }]]
+ }
+ case "typst": {
+ return [[rehypeTypst, opts?.typstOptions ?? {}]]
+ }
+ default:
+ case "mathjax": {
+ return [
+ [
+ rehypeMathjax,
+ {
+ ...(opts?.mathJaxOptions ?? {}),
+ tex: {
+ ...(opts?.mathJaxOptions?.tex ?? {}),
+ macros,
+ },
+ },
+ ],
+ ]
+ }
}
},
externalResources() {
- if (engine === "katex") {
- return {
- css: [
- // base css
- "https://cdn.jsdelivr.net/npm/katex@0.16.0/dist/katex.min.css",
- ],
- js: [
- {
- // fix copy behaviour: https://github.com/KaTeX/KaTeX/blob/main/contrib/copy-tex/README.md
- src: "https://cdn.jsdelivr.net/npm/katex@0.16.7/dist/contrib/copy-tex.min.js",
- loadTime: "afterDOMReady",
- contentType: "external",
- },
- ],
- }
- } else {
- return {}
+ switch (engine) {
+ case "katex":
+ return {
+ css: [{ content: "https://cdn.jsdelivr.net/npm/katex@0.16.11/dist/katex.min.css" }],
+ js: [
+ {
+ // fix copy behaviour: https://github.com/KaTeX/KaTeX/blob/main/contrib/copy-tex/README.md
+ src: "https://cdn.jsdelivr.net/npm/katex@0.16.11/dist/contrib/copy-tex.min.js",
+ loadTime: "afterDOMReady",
+ contentType: "external",
+ },
+ ],
+ }
}
},
}
--
Gitblit v1.10.0