Python第三方模块markdown【解析LaTex数学公式】并【在HTML文件中显示】

异想之旅:本人原创博客完全手敲,绝对非搬运,全网不可能有重复;本人无团队,仅为技术爱好者进行分享,所有内容不牵扯广告。本人所有文章仅在CSDN和个人博客(一定是异想之旅域名)发布,除此之外全部是盗文!


本人刚刚在使用Flask搭建的博客中成功加入了这个扩展,参考了大量文档和国内博主的博客,现将可用方案分享出来供参考,也作为个人记录用。

首先安装 markdown 及其扩展 python-markdown-math

pip install markdown
pip install python_markdown_math

写一个小程序测试下

from markdown import markdown


def md_to_html(md):
    html = markdown(md,
                    extensions=["mdx_math"],
                    extension_configs={
                        'mdx_math': {
                            'enable_dollar_delimiter': True,  # 是否启用单美元符号(默认只启用双美元)
                            'add_preview': True  # 在公式加载成功前是否启用预览(默认不启用)
                        }
                    })
    return html


print(md_to_html("$x^2$"))

输出内容如下

<p><span><span class="MathJax_Preview">$x^2$span><script type="math/tex">x^2script>span>p>

但是我们如果想要HTML渲染出来,还是要进行一些配置(此处是简化的HTML代码)

<p>
    <span>
    	<span class="MathJax_Preview">$x^2$span>
        <script type="math/tex">x^2script>
    span>
p>

<style>
    #MathJax_Message {
        display: none!important;
    }
style>
<script type="text/x-mathjax-config">
    MathJax.Hub.Config({
      config: ["MMLorHTML.js"],
      jax: ["input/TeX", "output/HTML-CSS", "output/NativeMML"],
      extensions: ["MathMenu.js", "MathZoom.js"]
    });
script>
<script type="text/javascript" src="https://cdn.jsdelivr.net/npm/mathjax@2/MathJax.js?config=TeX-MML-AM_CHTML">script>

有了这些代码,只要上文中出现了刚刚Python输出的内容,就会在页面初始化时自动格式化内容,效果如图

Python第三方模块markdown【解析LaTex数学公式】并【在HTML文件中显示】_第1张图片

CSS的作用是屏蔽加载过程中的进度提示(不加这个会有一个小小的div出现在页面左下角,虽然很快会消失但是还是很烦)

特别说明一下:最后一行加载的js地址在大陆是不能正常使用的,因此本人手动爬下来了所有的静态文件并放置在这两个链接里面了;其中第二个使用本人的自费CDN,如果您要使用(即便是非商用)请提前与我联系确认。

https://cdn.jsdelivr.net/gh/yxzlwz/mathjax-staticfile@master/MathJax.js
http://yxzlwz.githubcdn.yxzl.top/mathjax-staticfile/MathJax.js

这篇文章很短,但是牵扯到外网访问和英文文档阅读,还有从找解决方案到测试到优化等等,我足足用了4个小时,帮到的话不给关注还请点个赞吧~

说实话这个实现方案本人并不满意,没有动态方案就罢了官方文档也是问题百出,版本2和3差异极大,GitHub成堆的issues没人处理,GitHub仓库找不到代码,官方提供的CDN被中国网络长城封禁……以后有更好的方案再分享,大家先凑合,有好的也欢迎留言告知!

你可能感兴趣的:(Python,HTML,Web,python,html,开发语言)