Skip to content

一些在使用过程中逐步完善的插件内容

官方参考文档 reference

很不错的中文教程

latex 公式支持

这里使用的是Katex库,另一个amathjax使用发现不能成功渲染 添加到mkdoc.yml

mkdocs.yml
markdown_extensions:
  - pymdownx.arithmatex:
      generic: true

extra_javascript:
  - javascripts/katex.js
  - https://cdnjs.cloudflare.com/ajax/libs/KaTeX/0.16.7/katex.min.js
  - https://cdnjs.cloudflare.com/ajax/libs/KaTeX/0.16.7/contrib/auto-render.min.js

extra_css:
  - https://cdnjs.cloudflare.com/ajax/libs/KaTeX/0.16.7/katex.min.css
添加到/docs/javascripts/katex.js
katex.js
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
document$.subscribe(({ body }) => { 
  renderMathInElement(body, {
    delimiters: [
      { left: "$$",  right: "$$",  display: true },
      { left: "$",   right: "$",   display: false },
      { left: "\\(", right: "\\)", display: false },
      { left: "\\[", right: "\\]", display: true }
    ],
  })
})

渲染代码

添加到mkdocs.yml中的markdown_extensions中

mkdocs.yml
  - pymdownx.highlight:
      anchor_linenums: true
  - pymdownx.inlinehilite
  - pymdownx.snippets
  - pymdownx.superfences
外部代码引入使用 " --8<-- "xxx.xx" "

  • 添加行号使用 linenums="x" 表示从x开始

  • 添加代码标题使用 title="xxx"

部署至gitpage

部署博客教程

添加评论

这里参考了博文add commments，使用了giscus

Comments