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 | 87 ++++++++++++++++++++++++++++++-------------
1 files changed, 60 insertions(+), 27 deletions(-)
diff --git a/quartz/plugins/transformers/latex.ts b/quartz/plugins/transformers/latex.ts
index 7feeda8..a9f54f3 100644
--- a/quartz/plugins/transformers/latex.ts
+++ b/quartz/plugins/transformers/latex.ts
@@ -1,43 +1,76 @@
import remarkMath from "remark-math"
-import rehypeKatex from 'rehype-katex'
-import rehypeMathjax from 'rehype-mathjax/svg.js'
+import rehypeKatex from "rehype-katex"
+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) => {
- const engine = opts?.renderEngine ?? 'katex'
+// 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() {
- return [
- engine === 'katex'
- ? [rehypeKatex, { output: 'html' }]
- : [rehypeMathjax]
- ]
- },
- externalResources() {
- return engine === 'katex'
- ? {
- 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'
- }
+ 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() {
+ 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