Cannot render align environment (new feature of KaTeX 0.13)

[hotarugali]

Problem

Katex supports align environment https://katex.org/docs/support_table.html, but it seems that Markdown All In One doesn't support. When I write align environment in my vscode, Markdown All In One render error, just as follows:

Or are there some options needed to be set?
Thanks.

[yzhang-gh]

Thanks for the feedback.

I have updated the KaTeX module. Please check out the dev build.

[Lemmingh]

It is strange and tedious that we have to bump markdown-it-katex every time updating KaTeX.

We should relax the range there and control its version here.

What about:

{
  "dependencies": {
    "katex": "*"
  },
  "devDependencies": {
    "jest": "^26.6.3",
    "markdown-it": "12",
    "markdown-it-testgen": "^0.1.6"
  },
  "peerDependencies": {
    "katex": "0",
    "markdown-it": ">=6"
  }
}

[yzhang-gh]

peerDependencies

Interesting.

It is strange and tedious that we have to bump markdown-it-katex every time updating KaTeX.

It was not an issue before as KaTeX only updates few times every year, although there have been quite a few patches recently.

I agree with the suggested solution. Only one small question: what is the meaning of 0 in "katex": "0"?

[Lemmingh]

In an X-Range, x is optional. Thus, 0 is equivalent to 0.x.x, and is interpreted as >=0.0.0 <1.0.0.

---

dependencies declares requirement.

"katex": "*" says the package relies on any KaTeX.

peerDependencies declares compatibility.

"katex": "0" says the package is expected to be compatible with all KaTeX 0.x.x versions.

npm v6 and v7 process peerDependencies slightly differently. But it shouldn't affect us in a few years.

---

In this way, markdown-it-katex won't lock things tightly.

[yzhang-gh]

Thanks

[Firestar-Reimu]

Update 2021.11

still does not support align

Even markdown original support by vscode supports this: (I shut down the math support)

[Lemmingh]

#966

Sorry for the inconvenience. Please try the dev build for now:
https://github.com/yzhang-gh/vscode-markdown#latest-development-build

[Firestar-Reimu]

OK, solved. Wish that it will release soon.

[yzhang-gh]

released in v3.4.2