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]

感谢，解决了！

[WeMingT]

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
> $$

呈现效果如下：

我发现katex支持的数学公式有限，于是配置mathjax与之前的goldmark，然后这个问题又出现了，请问有在保留mathjax渲染数学公式和第一种写法的基础上能在hugo中正常显示的方法吗？

[Lruihao]

数学公式 在 FixIt 0.4.x 版本已完成重构，支持 KaTeX 或 MathJax，并且不再需要字符转义。

[i4mhmh]

您好，目前公式右边拖动条能取消掉了吗？

[Lruihao]

纵向的滚动条已经去掉了，但是横向的还是保留，防止长公式溢出屏幕。

[i4mhmh]

好的，我去更新一下，谢谢您。

[i4mhmh]

提个建议哈，能否设置成鼠标悬浮的上去的时候显示滚动条？因为文章里公式多的话有点影响观感，我刚看的 github 最新的是 v0.3.20额，如果最近不更新的话，能否等您推送更新了能否麻烦告知我一下。

[Lruihao]

在 main 分支暂时没有发新版本，我想等完成更多功能后一起发布，你可以把主题切到 main 分支或者直接下载。

鼠标悬浮的上去的时候显示滚动条，这个特性各浏览器（Mac和 ios系统上浏览器除外）已经删除了相关的 CSS 特性。如果觉得滚动条太多，可以尝试自定义样式，改一下公式滚动条的样式。

[i4mhmh]

好的 谢谢您