前言#
日常记录笔记、撰写技术博文时，我一直习惯使用 Typora 作为主力写作工具。在学习数学、计算机、密码学等相关知识时，文章中会频繁用到各类数学公式、符号表达式。
Typora 原生完美支持 LaTeX 公式语法，编写、预览公式都十分便捷。但将撰写好的 Markdown 文章部署到 Hugo Blowfish 主题博客后，会出现数学公式无法正常渲染、代码标记裸露的问题。
本文将详细讲解 Blowfish 主题下 KaTeX 数学表达式 的正确使用方案，适配 Typora 写作习惯，解决博客公式渲染异常问题。下面是我Typora的设置
一、Blowfish 主题 KaTeX 核心规则#
Blowfish 主题已内置集成 KaTeX 公式渲染引擎，无需额外安装插件、配置依赖，但必须在文章中声明 KaTeX 短代码，页面才能正常解析并渲染数学公式，否则所有 LaTeX 公式都会失效，直接以原始代码形式展示。
根据 Blowfish 官方文档要求，在文章任意位置添加以下短代码即可启用全局公式渲染（单篇文章仅需添加一次）：
该短代码仅为渲染声明，博客前端页面不会展示任何内容，仅后台激活 KaTeX 渲染能力，不影响文章排版和美观。就像我信安笔记中的
因为我这里是写的所以会看到标签或者标记，但是在博客页面显示的时候是不会出现的，下面就是在博客页面显示的效果
二、两种常用数学公式写法（适配全场景）#
Blowfish 主题完全兼容标准 KaTeX 语法，同时适配 Typora 的 LaTeX 编写习惯，主要分为内联数学表达式和块级数学表达式两种用法，可根据排版需求灵活选择。
1. 内联数学表达式（行内公式）#
适用于文章段落中穿插的简单数学符号、计算公式，公式与文字同行显示，不单独占行，适合简短表达式。
语法规则：将公式内容包裹在 \( \) 分隔符中
示例代码：
\( 7d = 1 + 40k \)
2. 块级数学表达式（独立公式块）#
适用于需要突出展示、单独成行的完整公式、推导式，公式会居中显示、独占一行，排版更整洁，适合核心公式、定理展示。
语法规则：将公式内容包裹在 $$ $$ 分隔符中，独占代码块
示例代码：
$$
55 = 5 \times 11
$$三、完整使用流程总结#
Typora 正常写作：按照日常习惯使用 LaTeX 语法编写各类数学公式，无需特殊适配；
添加渲染声明：文章末尾或开头添加一次
短代码；区分公式类型：行内简短公式用
\( \)，独立核心公式用$$ $$；部署预览：重新部署博客，即可正常渲染所有数学表达式。
四、常见问题说明#
注意事项
1. katex 短代码单篇文章仅需一次，重复添加不报错，但无额外效果；
2. 语法完全兼容 Typora，无需修改原有公式代码，仅需补充渲染声明；
3. 支持绝大多数 LaTeX 数学符号、公式语法，满足学习、笔记、技术博文的日常使用需求。
