@cobapen/markdown 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Yamavol
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,12 @@
+# cp-markdown
+
+A markdown converter for the cobapen website. 
+
+## Features
+
+- toc
+- anchor & footnote 
+- deflist
+- fenced code block with filename, line-number
+- server side math rendering
+

package/dist/code/fence-custom.d.ts

@@ -0,0 +1,13 @@
+import { Options } from "markdown-it/index.mjs";
+import Renderer from "markdown-it/lib/renderer.mjs";
+import Token from "markdown-it/lib/token.mjs";
+interface Env {
+    showCodeTitleByDefault?: boolean;
+}
+/**
+ * Custom fence renderer for markdown-it.
+ *
+ * see: markdown-it/lib/renderer.mjs
+ */
+export declare function fence_custom(tokens: Token[], idx: number, options: Options, env: Env, slf: Renderer): string;
+export {};

package/dist/code/fence-custom.js

@@ -0,0 +1,51 @@
+import { escapeHtml, unescapeAll } from "markdown-it/lib/common/utils.mjs";
+import { InfoString } from "./info-string.js";
+/**
+ * Custom fence renderer for markdown-it.
+ *
+ * see: markdown-it/lib/renderer.mjs
+ */
+export function fence_custom(tokens, idx, options, env, slf) {
+    var token = tokens[idx];
+    var info_str = token.info ? unescapeAll(token.info).trim() : "";
+    var info = new InfoString(info_str);
+    var langName = info.lang;
+    var langAttrs = info.attrs.join(" ");
+    var highlighted;
+    if (options.highlight) {
+        highlighted = options.highlight(token.content, langName, langAttrs) || escapeHtml(token.content);
+    }
+    else {
+        highlighted = escapeHtml(token.content);
+    }
+    if (highlighted.indexOf("<pre") === 0) {
+        return highlighted + "\n";
+    }
+    // If language exists, inject class gently, without modifying original token.
+    // May be, one day we will add .deepClone() for token and simplify this part, but
+    // now we prefer to keep things local.
+    if (info.hasLang) {
+        var i = token.attrIndex("class");
+        var tmpAttrs = token.attrs ? token.attrs.slice() : [];
+        if (i < 0) {
+            tmpAttrs.push(["class", options.langPrefix + langName]);
+        }
+        else {
+            tmpAttrs[i] = tmpAttrs[i].slice();
+            tmpAttrs[i][1] += " " + options.langPrefix + langName;
+        }
+        // Fake token just to render attributes
+        var tmpToken = {
+            attrs: tmpAttrs
+        };
+        if (info.title.length > 0) {
+            var style = (env.showCodeTitleByDefault === true)
+                ? ""
+                : " style=\"visibility:hidden;\"";
+            return "<pre><code".concat(slf.renderAttrs(tmpToken), ">").concat(highlighted, "</code><span class=\"title\"").concat(style, ">").concat(info.title, "</span></pre>\n");
+        }
+        return "<pre><code".concat(slf.renderAttrs(tmpToken), ">").concat(highlighted, "</code></pre>\n");
+    }
+    return "<pre><code".concat(slf.renderAttrs(token), ">").concat(highlighted, "</code></pre>\n");
+}
+//# sourceMappingURL=fence-custom.js.map

package/dist/code/highlight.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Highlight function with line number support
+ *
+ * @param code
+ * @param lang
+ * @param linestart
+ * @returns
+ */
+export declare function highlightWithLineNumber(code: string, lang: string, linestart?: number): string;
+/**
+ * Exported function for markdown-it
+ *
+ * @param str
+ * @param lang
+ * @param attrs
+ * @returns
+ */
+export declare function highlighterForMarkdownIt(str: string, lang: string, attrs: string): string;

package/dist/code/highlight.js

@@ -0,0 +1,95 @@
+/**
+ * highlight.ts
+ * 2023-11-20
+ * provides a custom highlighter for MarkdownIt
+ */
+import hljs from "highlight.js";
+import { InfoString } from "./info-string.js";
+function _debuglog() {
+    var _args = [];
+    for (var _i = 0; _i < arguments.length; _i++) {
+        _args[_i] = arguments[_i];
+    }
+    // if (_debuglog.caller.name !== "") return;
+    // console.log(...args);
+}
+/** Get digits of the number. e.g. 1000 => 4 */
+function numDigits(n) {
+    return Math.floor(n).toString().length;
+}
+/** Print a decimal nicely */
+function niceDec(n) {
+    return n.toFixed(3);
+}
+/**
+ * Highlight function with line number support
+ *
+ * @param code
+ * @param lang
+ * @param linestart
+ * @returns
+ */
+export function highlightWithLineNumber(code, lang, linestart) {
+    try {
+        /** convert if lang is specified + supported by highlight.js */
+        if (lang && hljs.getLanguage(lang)) {
+            /** do conversion */
+            var htmlLines = hljs.highlight(code, { language: lang }).value;
+            /**
+             * Attach the line number if specified.
+             *
+             * The given code is rendered in <pre><code>, so each line is terminated by '\n'.
+             * Split the input, wrap them by <div class="line">.
+             * At the beginning of each line, <span class="line-no"> is added.
+             *
+             * default styles are embedded so that the text is readable
+             * even if css was not applied.
+             *
+             * default-styles:
+             * - display: inline-block
+             * - user-select: none
+             * - width: ${numDigits}em
+             */
+            if (linestart !== undefined) {
+                var lines = htmlLines.split("\n");
+                var elWidth = numDigits(linestart + lines.length) * 0.8;
+                var elStyle_1 = "display:inline-block;" +
+                    "user-select:none;" +
+                    "width: ".concat(niceDec(elWidth), "em;");
+                lines.forEach(function (line, i, lines) {
+                    lines[i] =
+                        "<div class=\"line\">" +
+                            "<span class=\"line-no\" style=\"".concat(elStyle_1, "\">").concat(linestart + i, "</span>").concat(line) +
+                            "</div>";
+                });
+                _debuglog(lines);
+                htmlLines = lines.join("");
+            }
+            return htmlLines;
+        }
+        else {
+            // no language , no highlighting.
+            // If you want line numbers without highlighting, set language to
+            // "nohighlight" or "text"
+            return "";
+        }
+    }
+    catch (_) {
+        return "";
+    }
+}
+/**
+ * Exported function for markdown-it
+ *
+ * @param str
+ * @param lang
+ * @param attrs
+ * @returns
+ */
+export function highlighterForMarkdownIt(str, lang, attrs) {
+    _debuglog(lang ? lang : "(lang is empty or undefined)");
+    var info = new InfoString(lang + " " + attrs);
+    _debuglog(info);
+    return highlightWithLineNumber(str, info.lang, info.linestart);
+}
+//# sourceMappingURL=highlight.js.map

package/dist/code/info-string.d.ts

@@ -0,0 +1,26 @@
+/**
+ * InfoString parses info_string from fenced code block.
+ */
+export declare class InfoString {
+    private readonly _lang;
+    private readonly _attrs;
+    private readonly _title;
+    private readonly _linestart;
+    constructor(info: string);
+    get lang(): string;
+    get attrs(): string[];
+    get title(): string;
+    get linestart(): number | undefined;
+    get hasLang(): boolean;
+    /** Parse info_string into an array of strings. All quotes are removed*/
+    static parseInfoString(info: string): string[];
+    /** Parse metadata notation "{filename:line, ...}"" */
+    static parseMetaNotation(text: string): {
+        filename: string;
+        line: number;
+    } | undefined;
+    /** From attributes list, return title metadata */
+    static getTitle(attr: string[]): string;
+    /** From attributes list, return line number if defined */
+    static getLineStart(attr: string[]): number | undefined;
+}

package/dist/code/info-string.js

@@ -0,0 +1,149 @@
+/**
+ * InfoString parses info_string from fenced code block.
+ */
+var InfoString = /** @class */ (function () {
+    function InfoString(info) {
+        if (info.length > 0) {
+            var arr = InfoString.parseInfoString(info);
+            this._lang = arr[0];
+            this._attrs = arr.slice(1);
+            this._title = InfoString.getTitle(this._attrs);
+            this._linestart = InfoString.getLineStart(this._attrs);
+        }
+        else {
+            this._lang = "";
+            this._attrs = [];
+            this._title = "";
+            this._linestart = undefined;
+        }
+    }
+    Object.defineProperty(InfoString.prototype, "lang", {
+        get: function () {
+            return this._lang;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(InfoString.prototype, "attrs", {
+        get: function () {
+            return this._attrs;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(InfoString.prototype, "title", {
+        get: function () {
+            return this._title;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(InfoString.prototype, "linestart", {
+        get: function () {
+            return this._linestart;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(InfoString.prototype, "hasLang", {
+        get: function () {
+            return this._lang.length > 0;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    /** Parse info_string into an array of strings. All quotes are removed*/
+    InfoString.parseInfoString = function (info) {
+        // There are 4 possible tokens, but it can be reduced to 2 patterns.
+        // arg, "arg quoted", key=value, key="value quoted"
+        // 
+        // This function returns a quote-removed string. 
+        // 
+        // const regex = /([^\s]+=)?(?:"([^"]*)"|'([^']*)'|([^\s]+))/g;
+        //                 ~~~~~~~~     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 
+        //                 key=         "value" 'value' value
+        //
+        // The regex above does not support escape letters. The next regex
+        // is escape char aware. 
+        // 
+        // NOTE: This class is designed to handle escape letters. However, tools 
+        // might decide to unescape info_string before used (e.g. markdown-it). 
+        // In such case, you might need to use double-escaped quotes.
+        // 
+        var dq = "[^\"\\\\]*(?:\\\\.|[^\"\\\\]*)*"; // [^"]*
+        var sq = "[^\'\\\\]*(?:\\\\.|[^\'\\\\]*)*"; // [^']*
+        //          ~~~~~~~~~~   ~~~~~ ~~~~~~~~~~
+        //          char seq   ( escape  char seq )*
+        // 
+        var ptn = "([^\\s]+=)?(?:\"(".concat(dq, ")\"|'(").concat(sq, ")'|([^\\s]+))");
+        //           ~~~~~~~~~~    ~~~~~~~~~ ~~~~~~~~~ ~~~~~~~~~
+        //           key=          "value"   'value'   value
+        var regex = new RegExp(ptn, "g");
+        var result = [];
+        var match;
+        while ((match = regex.exec(info)) !== null) {
+            var text = (match[1] || "") + (match[2] || match[3] || match[4] || "");
+            text = unescape(text).trim();
+            result.push(text);
+        }
+        return result;
+    };
+    /** Parse metadata notation "{filename:line, ...}"" */
+    InfoString.parseMetaNotation = function (text) {
+        var match = text.match(/^\{\s*([^:]+):(\d+)\s*\}$/);
+        if (match) {
+            return {
+                filename: match[1],
+                line: parseInt(match[2], 10),
+            };
+        }
+        return undefined;
+    };
+    /** From attributes list, return title metadata */
+    InfoString.getTitle = function (attr) {
+        var _a;
+        var titleAttr = (_a = attr.find(function (x) { return x.startsWith("title="); })) !== null && _a !== void 0 ? _a : "";
+        if (titleAttr.length > 0) {
+            var match = titleAttr.match(/^title=(.*)$/);
+            if (match) {
+                var value = match[1].trim();
+                if (value.startsWith("\"") && value.endsWith("\"")) {
+                    value = value.slice(1, -1);
+                    value = unescape(value).trim();
+                }
+                return value;
+            }
+            else {
+                throw new Error("Must not fail. Check impl.");
+            }
+        }
+        if (attr.length > 0) {
+            var meta = InfoString.parseMetaNotation(attr[0]);
+            if (meta && meta.filename.length > 0) {
+                return meta.filename;
+            }
+        }
+        return "";
+    };
+    /** From attributes list, return line number if defined */
+    InfoString.getLineStart = function (attr) {
+        var _a;
+        var lineAttr = (_a = attr.find(function (x) { return x.startsWith("linestart="); })) !== null && _a !== void 0 ? _a : "";
+        if (lineAttr.length > 0) {
+            return parseInt(lineAttr.split("=")[1].trim());
+        }
+        if (attr.length > 0) {
+            var meta = InfoString.parseMetaNotation(attr[0]);
+            if (meta && meta.line > 0) {
+                return meta.line;
+            }
+        }
+        return undefined;
+    };
+    return InfoString;
+}());
+export { InfoString };
+function unescape(text) {
+    return text.replaceAll(/\\\"/g, "\"").replaceAll(/\\\'/g, "'");
+}
+//# sourceMappingURL=info-string.js.map

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+export interface Configuration {
+    /**
+     * Set "true" to display the title (if specified) of the fenced code block.
+     * The title is hidden by default, and user must explicitly override the style.
+     */
+    showCodeTitleByDefault: boolean;
+}
+export type Options = Partial<Configuration>;
+export declare class MarkdownConverter {
+    private readonly _config;
+    private readonly _mj;
+    private readonly _md;
+    constructor(option?: Options);
+    render(text: string): string;
+    mathcss(): string;
+}

package/dist/index.js

@@ -0,0 +1,67 @@
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+import markdownIt from "markdown-it";
+import { highlighterForMarkdownIt } from "./code/highlight.js";
+import anchor from "markdown-it-anchor";
+// @ts-ignore
+import cjkbreaks from "markdown-it-cjk-breaks";
+// @ts-ignore
+import deflist from "markdown-it-deflist";
+// @ts-ignore
+import toc from "markdown-it-table-of-contents";
+// @ts-ignore
+import footnote from "markdown-it-footnote";
+import { MathjaxEngine } from "./math/mathjax.js";
+import { mdmath } from "./math/mdmath.js";
+import { fence_custom } from "./code/fence-custom.js";
+var defaultOptions = {
+    showCodeTitleByDefault: false,
+};
+var MarkdownConverter = /** @class */ (function () {
+    function MarkdownConverter(option) {
+        var config = __assign(__assign({}, defaultOptions), option);
+        var mj = new MathjaxEngine({
+            tex: {
+                macros: {
+                    bm: ["\\boldsymbol{#1}", 1],
+                },
+            },
+        });
+        var md = markdownIt({
+            html: true,
+            linkify: true,
+            highlight: highlighterForMarkdownIt,
+        });
+        md.renderer.rules.fence = fence_custom;
+        md.use(anchor)
+            .use(cjkbreaks)
+            .use(footnote)
+            .use(deflist)
+            .use(mdmath(mj))
+            .use(toc, {
+            includeLevel: [2, 3],
+        });
+        this._config = config;
+        this._mj = mj;
+        this._md = md;
+    }
+    MarkdownConverter.prototype.render = function (text) {
+        var env = __assign({}, this._config); // env object must s
+        return this._md.render(text, env);
+    };
+    MarkdownConverter.prototype.mathcss = function () {
+        return this._mj.stylesheet();
+    };
+    return MarkdownConverter;
+}());
+export { MarkdownConverter };
+//# sourceMappingURL=index.js.map

package/dist/math/mathjax.d.ts

@@ -0,0 +1,97 @@
+/**
+ * mathjax.ts
+ *
+ * Server-Side Mathjax converter from TeX input to CommonHTML.
+ *
+ * see official examples for more information
+ * https://github.com/mathjax/mathjax-v3
+ * https://github.com/mathjax/MathJax-demos-node/blob/master/direct/tex2chtml
+*/
+import { type LiteAdaptor } from "mathjax-full/js/adaptors/liteAdaptor.js";
+import { LiteElement } from "mathjax-full/js/adaptors/lite/Element.js";
+import { type LiteText } from "mathjax-full/js/adaptors/lite/Text.js";
+import { type LiteDocument } from "mathjax-full/js/adaptors/lite/Document.js";
+import { type MathDocument } from "mathjax-full/js/core/MathDocument.js";
+import { TeX } from "mathjax-full/js/input/tex.js";
+import { CHTML } from "mathjax-full/js/output/chtml.js";
+type N = LiteElement;
+type T = LiteText;
+type D = LiteDocument;
+interface AnyObject {
+    [x: string]: any;
+}
+interface TexConfig {
+    packages: string | [string] | AnyObject;
+    inlineMath: [[string, string]];
+    displayMath: [[string, string]];
+    processEscapes: boolean;
+    processEnvironments: boolean;
+    processRefs: boolean;
+    digits: RegExp;
+    tags: string;
+    tagSide: string;
+    tagIndent: string;
+    useLabelIds: boolean;
+    multlineWidth: string;
+    maxMacros: number;
+    maxBuffer: number;
+    baseURL: string;
+    formatError: (jax: object, err: Error) => void;
+    macros: AnyObject;
+}
+interface CHTMLConfig {
+    scale: number;
+    minScale: number;
+    matchFontHeight: boolean;
+    mtextInheritFont: boolean;
+    merrorInheritFont: boolean;
+    mtextFont: string;
+    merrorFont: string;
+    mathmlspacing: boolean;
+    skipAttributes: AnyObject;
+    exFactor: number;
+    displayAlign: string;
+    displayIndent: number | string;
+    fontURL: string;
+    adaptiveCSS: boolean;
+}
+interface Options {
+    inline: boolean;
+    em: number;
+    ex: number;
+    width: number;
+    tex?: Partial<TexConfig>;
+    chtml?: Partial<CHTMLConfig>;
+}
+/**
+ * Initialize and encapsulates mathjax instances to generate
+ * CommonHTML from TeX input.
+ *
+ * There are 2 important methods. One converts the input.
+ * The other returns a stylesheet document. The stylesheet must be included
+ * in your HTML document to render the equation properly.
+ */
+export declare class MathjaxEngine {
+    option: Options;
+    adaptor: LiteAdaptor;
+    tex: TeX<N, T, D>;
+    chtml: CHTML<N, T, D>;
+    html: MathDocument<N, T, D>;
+    constructor(option?: Partial<Options>);
+    /**
+     * convert TeX input to CHTML.
+     *
+     * @param tex       input string
+     * @param override  parameter to override the defaults, if you wish to
+     * @returns
+     */
+    convert(tex: string, override?: Partial<Options>): string;
+    /**
+     * returns adaptive css (stylesheet for the processed equations only),
+     * or the full mathjax css (if configured)
+     *
+     * @returns css content
+     */
+    stylesheet(): string;
+}
+export {};

package/dist/math/mathjax.js

@@ -0,0 +1,108 @@
+/**
+ * mathjax.ts
+ *
+ * Server-Side Mathjax converter from TeX input to CommonHTML.
+ *
+ * see official examples for more information
+ * https://github.com/mathjax/mathjax-v3
+ * https://github.com/mathjax/MathJax-demos-node/blob/master/direct/tex2chtml
+*/
+import { liteAdaptor } from "mathjax-full/js/adaptors/liteAdaptor.js";
+import { LiteElement } from "mathjax-full/js/adaptors/lite/Element.js"; /* N */
+import { RegisterHTMLHandler } from "mathjax-full/js/handlers/html.js";
+import { TeX } from "mathjax-full/js/input/tex.js";
+import { mathjax } from "mathjax-full/js/mathjax.js";
+import { CHTML } from "mathjax-full/js/output/chtml.js";
+import { AllPackages } from "mathjax-full/js/input/tex/AllPackages.js";
+import { merge } from "lodash-es";
+var MATHJAX_DEFAULT_FONT_URL = "https://cdn.jsdelivr.net/npm/mathjax-full@3/es5/output/chtml/fonts/woff-v2";
+var defaultOption = {
+    inline: false,
+    em: 16,
+    ex: 8,
+    width: 80 * 16,
+    tex: {
+        packages: AllPackages,
+    },
+    chtml: {
+        scale: 1.21, // magic # chosen which look nice for me
+        fontURL: MATHJAX_DEFAULT_FONT_URL,
+        adaptiveCSS: true,
+        exFactor: 5,
+    },
+};
+/**
+ * Initialize and encapsulates mathjax instances to generate
+ * CommonHTML from TeX input.
+ *
+ * There are 2 important methods. One converts the input.
+ * The other returns a stylesheet document. The stylesheet must be included
+ * in your HTML document to render the equation properly.
+ */
+var MathjaxEngine = /** @class */ (function () {
+    function MathjaxEngine(option) {
+        var _a;
+        this.option = merge({}, defaultOption, option);
+        if (typeof ((_a = this.option.tex) === null || _a === void 0 ? void 0 : _a.packages) === "string") {
+            this.option.tex.packages = this.option.tex.packages.split(/\s*,\s*/);
+        }
+        this.adaptor = liteAdaptor();
+        RegisterHTMLHandler(this.adaptor);
+        var tex = new TeX(this.option.tex);
+        var chtml = new CHTML(this.option.chtml);
+        var html = mathjax.document("", {
+            InputJax: tex,
+            OutputJax: chtml,
+        });
+        html.addRenderAction("typeset", 155, renderDoc, renderMath);
+        this.tex = tex;
+        this.chtml = chtml;
+        this.html = html;
+        function renderDoc(_doc) { }
+        function renderMath(math, doc) {
+            var adaptor = doc.adaptor;
+            var text = adaptor.node("mjx-copytext", { "aria-hidden": true }, [
+                adaptor.text(math.math),
+            ]);
+            adaptor.setStyle(text, "position", "absolute");
+            adaptor.setStyle(text, "visibility", "hidden");
+            adaptor.setStyle(math.typesetRoot, "position", "relative");
+            adaptor.append(math.typesetRoot, text);
+        }
+    }
+    /**
+     * convert TeX input to CHTML.
+     *
+     * @param tex       input string
+     * @param override  parameter to override the defaults, if you wish to
+     * @returns
+     */
+    MathjaxEngine.prototype.convert = function (tex, override) {
+        var _a, _b, _c, _d;
+        var node = this.html.convert(tex, {
+            display: !((_a = override === null || override === void 0 ? void 0 : override.inline) !== null && _a !== void 0 ? _a : this.option.inline),
+            em: (_b = override === null || override === void 0 ? void 0 : override.em) !== null && _b !== void 0 ? _b : this.option.em,
+            ex: (_c = override === null || override === void 0 ? void 0 : override.ex) !== null && _c !== void 0 ? _c : this.option.ex,
+            containerWidth: (_d = override === null || override === void 0 ? void 0 : override.width) !== null && _d !== void 0 ? _d : this.option.width,
+            scale: 1.0,
+        });
+        if (node instanceof LiteElement) {
+            return this.adaptor.outerHTML(node);
+        }
+        else {
+            return "ERROR";
+        }
+    };
+    /**
+     * returns adaptive css (stylesheet for the processed equations only),
+     * or the full mathjax css (if configured)
+     *
+     * @returns css content
+     */
+    MathjaxEngine.prototype.stylesheet = function () {
+        return this.adaptor.textContent(this.chtml.styleSheet(this.html));
+    };
+    return MathjaxEngine;
+}());
+export { MathjaxEngine };
+//# sourceMappingURL=mathjax.js.map

package/dist/math/mdmath.d.ts

@@ -0,0 +1,14 @@
+/**
+ * mdmath.ts
+ *
+ * MarkdownIt extension for math equation processing
+ */
+import { PluginSimple } from "markdown-it";
+import { MathjaxEngine } from "./mathjax.js";
+/**
+ * returns a Markdown-It plugin
+ *
+ * @param math    mathjax Engine to use
+ * @returns
+ */
+export declare function mdmath(math: MathjaxEngine): PluginSimple;

package/dist/math/mdmath.js

@@ -0,0 +1,67 @@
+/**
+ * mdmath.ts
+ *
+ * MarkdownIt extension for math equation processing
+ */
+import katex from "katex";
+import { math_block, math_inline } from "./mdparser.js";
+/**
+ * Returns a MarkdownIt renderer to render inline/block TeX into HTML.
+ * `KaTeX` is used for inline math, `MathJax` is used for block math.
+ *
+ * @param mathjax   mathjax engine (used for block math processing)
+ * @returns
+ */
+function getRenderers(mathjax) {
+    function renderInlineMath(tex) {
+        return katex.renderToString(tex, {
+            throwOnError: false,
+            strict: function (code, _msg, _token) {
+                switch (code) {
+                    case "unicodeTextInMathMode":
+                        return "ignore";
+                    default:
+                        return "warn";
+                }
+            },
+        });
+    }
+    function renderBlockMath(tex) {
+        try {
+            var math = mathjax.convert(tex);
+            return "<p>" + math + "</p>";
+        }
+        catch (err) {
+            console.error(err);
+            return tex;
+        }
+    }
+    function inlineRenderer(tokens, index) {
+        return renderInlineMath(tokens[index].content);
+    }
+    function blockRenderer(tokens, index) {
+        return renderBlockMath(tokens[index].content + "\n");
+    }
+    return {
+        inlineRenderer: inlineRenderer,
+        blockRenderer: blockRenderer,
+    };
+}
+/**
+ * returns a Markdown-It plugin
+ *
+ * @param math    mathjax Engine to use
+ * @returns
+ */
+export function mdmath(math) {
+    var renderer = getRenderers(math);
+    return function (md) {
+        md.inline.ruler.after("escape", "math_inline", math_inline);
+        md.block.ruler.after("blockquote", "math_block", math_block, {
+            alt: ["paragraph", "reference", "blockquote", "list"],
+        });
+        md.renderer.rules.math_inline = renderer.inlineRenderer;
+        md.renderer.rules.math_block = renderer.blockRenderer;
+    };
+}
+//# sourceMappingURL=mdmath.js.map

package/dist/math/mdparser.d.ts

@@ -0,0 +1,9 @@
+/**
+ * mdparser.ts
+ *
+ * provides methods to parse MarkdownIt token stream and extract math equations.
+ */
+import StateBlock from "markdown-it/lib/rules_block/state_block.mjs";
+import StateInline from "markdown-it/lib/rules_inline/state_inline.mjs";
+export declare function math_inline(state: StateInline, silent: boolean): boolean;
+export declare function math_block(state: StateBlock, start: number, end: number, silent: boolean): boolean;

package/dist/math/mdparser.js

@@ -0,0 +1,148 @@
+/**
+ * mdparser.ts
+ *
+ * provides methods to parse MarkdownIt token stream and extract math equations.
+ */
+/**
+ * Tests if potential opening or closing delimieter
+ * Assumes that there is a "$" at state.src[pos]
+ */
+function isValidDelim(state, pos) {
+    var max = state.posMax;
+    var can_open = true;
+    var can_close = true;
+    var prevChar = pos > 0 ? state.src.charCodeAt(pos - 1) : -1;
+    var nextChar = pos + 1 <= max ? state.src.charCodeAt(pos + 1) : -1;
+    // Check non-whitespace conditions for opening and closing, and
+    // check that closing delimeter isn't followed by a number
+    if (prevChar === 0x20 /* " " */ ||
+        prevChar === 0x09 /* \t */ ||
+        (nextChar >= 0x30 /* "0" */ && nextChar <= 0x39) /* "9" */) {
+        can_close = false;
+    }
+    if (nextChar === 0x20 /* " " */ || nextChar === 0x09 /* \t */) {
+        can_open = false;
+    }
+    return {
+        can_open: can_open,
+        can_close: can_close,
+    };
+}
+export function math_inline(state, silent) {
+    var match, token, res, pos;
+    if (state.src[state.pos] !== "$") {
+        return false;
+    }
+    res = isValidDelim(state, state.pos);
+    if (!res.can_open) {
+        if (!silent) {
+            state.pending += "$";
+        }
+        state.pos += 1;
+        return true;
+    }
+    // First check for and bypass all properly escaped delimieters
+    // This loop will assume that the first leading backtick can not
+    // be the first character in state.src, which is known since
+    // we have found an opening delimieter already.
+    var start = state.pos + 1;
+    match = start;
+    while ((match = state.src.indexOf("$", match)) !== -1) {
+        // Found potential $, look for escapes, pos will point to
+        // first non escape when complete
+        pos = match - 1;
+        while (state.src[pos] === "\\") {
+            pos -= 1;
+        }
+        // Even number of escapes, potential closing delimiter found
+        if ((match - pos) % 2 == 1) {
+            break;
+        }
+        match += 1;
+    }
+    // No closing delimter found.  Consume $ and continue.
+    if (match === -1) {
+        if (!silent) {
+            state.pending += "$";
+        }
+        state.pos = start;
+        return true;
+    }
+    // Check if we have empty content, ie: $$.  Do not parse.
+    if (match - start === 0) {
+        if (!silent) {
+            state.pending += "$$";
+        }
+        state.pos = start + 1;
+        return true;
+    }
+    // Check for valid closing delimiter
+    res = isValidDelim(state, match);
+    if (!res.can_close) {
+        if (!silent) {
+            state.pending += "$";
+        }
+        state.pos = start;
+        return true;
+    }
+    if (!silent) {
+        token = state.push("math_inline", "math", 0);
+        token.markup = "$";
+        token.content = state.src.slice(start, match);
+    }
+    state.pos = match + 1;
+    return true;
+}
+export function math_block(state, start, end, silent) {
+    var firstLine;
+    var lastLine;
+    var next;
+    var lastPos;
+    var found = false;
+    var pos = state.bMarks[start] + state.tShift[start];
+    var max = state.eMarks[start];
+    if (pos + 2 > max) {
+        return false;
+    }
+    if (state.src.slice(pos, pos + 2) !== "$$") {
+        return false;
+    }
+    pos += 2;
+    firstLine = state.src.slice(pos, max);
+    if (silent) {
+        return true;
+    }
+    if (firstLine.trim().slice(-2) === "$$") {
+        // Single line expression
+        firstLine = firstLine.trim().slice(0, -2);
+        found = true;
+    }
+    for (next = start; !found;) {
+        next++;
+        if (next >= end) {
+            break;
+        }
+        pos = state.bMarks[next] + state.tShift[next];
+        max = state.eMarks[next];
+        if (pos < max && state.tShift[next] < state.blkIndent) {
+            // non-empty line with negative indent should stop the list:
+            break;
+        }
+        if (state.src.slice(pos, max).trim().slice(-2) === "$$") {
+            lastPos = state.src.slice(0, max).lastIndexOf("$$");
+            lastLine = state.src.slice(pos, lastPos);
+            found = true;
+        }
+    }
+    state.line = next + 1;
+    var token = state.push("math_block", "math", 0);
+    token.block = true;
+    token.content =
+        (firstLine && firstLine.trim() ? firstLine + "\n" : "") +
+            state.getLines(start + 1, next, state.tShift[start], true) +
+            (lastLine && lastLine.trim() ? lastLine : "");
+    token.map = [start, state.line];
+    token.markup = "$$";
+    return true;
+}
+//# sourceMappingURL=mdparser.js.map

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@cobapen/markdown",
+  "version": "0.1.0",
+  "description": "A markdown converter for cobapen website",
+  "license": "MIT",
+  "author": "yamavol",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "directories": {
+    "doc": "docs",
+    "test": "tests"
+  },
+  "keywords": [
+    "markdown"
+  ],
+  "homepage": "https://github.com/cobapen/markdown#readme",
+  "bugs": {
+    "url": "https://github.com/cobapen/markdown/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cobapen/markdown.git"
+  },
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.d.ts"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "build:doc": "tsc && node docs/build.js",
+    "test": "vitest",
+    "coverage": "vitest run --coverage"
+  },
+  "dependencies": {
+    "highlight.js": "^11.11.1",
+    "katex": "^0.16.22",
+    "lodash-es": "^4.17.21",
+    "markdown-it": "^14.1.0",
+    "markdown-it-anchor": "^9.2.0",
+    "markdown-it-cjk-breaks": "^2.0.0",
+    "markdown-it-deflist": "^3.0.0",
+    "markdown-it-footnote": "^4.0.0",
+    "markdown-it-table-of-contents": "^0.9.0",
+    "mathjax-full": "^3.2.2"
+  },
+  "devDependencies": {
+    "@stylistic/eslint-plugin": "^4.2.0",
+    "@types/katex": "^0.16.7",
+    "@types/lodash-es": "^4.17.12",
+    "@types/markdown-it": "^14.1.2",
+    "@types/mustache": "^4.2.5",
+    "@types/node": "^22.14.1",
+    "@vitest/coverage-v8": "^3.1.1",
+    "eslint": "^9.24.0",
+    "mustache": "^4.2.0",
+    "typescript": "^5.8.3",
+    "typescript-eslint": "^8.29.1",
+    "vitest": "^3.1.1"
+  }
+}