Markdown 扩展语法 | FixIt

[giscus[bot]]

Markdown 扩展语法 | FixIt

这篇文章展示了扩展的 Markdown 语法和格式。

https://fixit.lruihao.cn/zh-cn/documentation/content-management/markdown-syntax/extended/

[deepreadingnet]

zan

[realjimmy]

请问，文章末尾的“相关内容”是怎么添加的呢？推荐逻辑是什么呢？感谢回复。

[Lruihao]

    # FixIt 0.3.0 | 新增 相关内容配置 (https://gohugo.io/content-management/related/)
    [params.page.related]
      enable = false
      count = 5

[Lruihao]

已经补充完整的文档：Related Content

[WeMingT]

callouts中使用$$...$$行间数学公式会在公式前后各多一个>符号

异常状况

> [!solution]- solution
> 矩阵 $A$ 的特征方程为：
> 
> $$
> \det(A - \lambda I) = \begin{vmatrix} -5-\lambda & -1 \\ 1 & -3-\lambda \end{vmatrix} = (\lambda + 4)^2 = 0
> $$

会显示为

公式前后各多一个>符号

而如果去掉中间公式与最后一个$$前面的>符号，则显示正常

> [!solution]- solution
> 矩阵 $A$ 的特征方程为：
> 
> $$
 \det(A - \lambda I) = \begin{vmatrix} -5-\lambda & -1 \\ 1 & -3-\lambda \end{vmatrix} = (\lambda + 4)^2 = 0
$$

显示为

我的goldmark配置

[markup]
  _merge = "shallow"
  [markup.goldmark]
    [markup.goldmark.extensions]
      [markup.goldmark.extensions.passthrough]
        enable = true
        [markup.goldmark.extensions.passthrough.delimiters]
          block = [['\[', '\]'], ['$$', '$$']]
          inline = [['\(', '\)'], ['$','$']]

一点想法

我怀疑是goldmark将$$...$$中的所有>符号都算做了数学公式，但是这些符号中有些本该是用作markdown语法的。

求助

如何在保留第一种写法的基础上使之在hugo中正常显示，不多加>符号？

[Lruihao]

FixIt 主题的公式暂时没有基于 Hugo 的 passthrough 来实现，反而配置了会冲突，需要移除 markup.goldmark.extensions.passthrough.delimiters 配置。在 callouts 中使用的话，部分符号需要需要转义：

例如：^ 转义为 \^、\ 转义为 \\,具体如下图，或者看上面文档中。

你的例子可以这样写：

> [!solution]- solution
> 矩阵 $A$ 的特征方程为：
> 
> $$
> \det(A - \lambda I) = \begin{vmatrix} -5-\lambda & -1 \\\\ 1 & -3-\lambda \end{vmatrix} = (\lambda + 4)\^2 = 0
> $$

呈现效果如下：

[WeMingT]

感谢，解决了！