You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: source/docs/third-party-services/math-equations.md
+12-8Lines changed: 12 additions & 8 deletions
Original file line number
Diff line number
Diff line change
@@ -69,17 +69,13 @@ For now, NexT provides two rendering engines for displaying Math Equations: [Mat
69
69
- MathJax is a JavaScript display engine for mathematics that works in all browsers. It is highly modular on input and output. Use MathML, TeX, and ASCIImath as input and produce HTML+CSS, SVG, or MathML as output.
70
70
- [KaTeX is a faster](https://www.intmath.com/cg5/katex-mathjax-comparison.php) math rendering engine compared to MathJax 3. And it could survive without JavaScript. But, for now [KaTeX supports less features](https://github.com/KaTeX/KaTeX/wiki/Things-that-KaTeX-does-not-(yet)-support) than MathJax. Here is a list of [TeX functions supported by KaTeX](https://katex.org/docs/supported.html).
71
71
72
-
Firstly, you need to choose a rendering engine and turn on `enable` for it in {% label primary@NexT config file %}. Then you need to install the **corresponding Hexo Renderer** to fully support the display of Math Equations - Only turn on `enable` **may not let you see the displayed equations correctly**.
72
+
Firstly, you need to choose a math rendering engine and turn on `enable` for it in {% label primary@NexT config file %}. Then you need to install the **corresponding Hexo Renderer** to fully support the display of Math Equations - Only turn on `enable` **may not let you see the displayed equations correctly**.
73
73
74
74
{% tabs render-engines %}
75
75
<!-- tab MathJax -->
76
76
**Renderer Choosing**
77
77
78
-
If you use MathJax to render Math Equations, you can choose one of the Markdown renderers below:
hexo-renderer-pandoc is recommended because it can handle mathematical formulas in markdown documents perfectly.
78
+
If you use MathJax to render Math Equations, you can choose [hexo-renderer-pandoc](https://github.com/wzpan/hexo-renderer-pandoc) as the Markdown renderer. It is recommended because it can handle mathematical formulas in markdown documents perfectly.
83
79
84
80
{% note warning %}
85
81
If you are using other renderers, such as [hexo-renderer-marked](https://github.com/hexojs/hexo-renderer-marked), you need to be aware of the conflict between LaTeX and Markdown syntax. For example, an underscore (`_`) may be interpreted as the start of italic text in Markdown, or subscripted mark in TeX. To avoid syntax errors, please use escape characters (`\_`) instead:
@@ -92,7 +88,6 @@ If you are using other renderers, such as [hexo-renderer-marked](https://github.
92
88
-\\
93
89
+\\\\
94
90
```
95
-
96
91
{% endnote %}
97
92
98
93
**Installation**
@@ -113,7 +108,16 @@ If you are using other renderers, such as [hexo-renderer-marked](https://github.
113
108
$ npm i hexo-renderer-pandoc
114
109
```
115
110
116
-
3. [pandoc](https://github.com/jgm/pandoc) is required for hexo-renderer-pandoc, here's [how to install pandoc](https://github.com/jgm/pandoc/blob/master/INSTALL.md).
111
+
3. If you are using `hexo-renderer-pandoc` version greater than 5.0.0, you need to set `pandoc.args` in {% label info@Hexo config file %}:
112
+
113
+
```yml Hexo config file
114
+
# config of hexo-renderer-pandoc
115
+
pandoc:
116
+
args:
117
+
- --mathjax
118
+
```
119
+
120
+
4. `hexo-renderer-pandoc` requires [pandoc](https://github.com/jgm/pandoc) to be installed, otherwise it will throw an error. Here's [how to install pandoc](https://github.com/jgm/pandoc/blob/master/INSTALL.md).
0 commit comments