本文主要是记录自己在Gridea写作时遇到的“问题”,有的时候想实现一种排版样式费尽九牛二虎之力才找到答案,特在此记录下来。顺便作为一篇Markdown的测试文章。在Gridea中写作时总能遇到一些问题,比如Gridea中的目录怎么显示?🤔 图片并排如何实现? 如何实现类似$\LaTeX$中的交叉引用,脚注 $\cdots\cdots$


1. 目录(Content)

  在Gridea中目录的实现可能与Markdown的语法有所不同,语法为@[TOC](大小写不敏感)。另外值得一提的一点是,当文章较长时即便有目录也无法很快跳转到指定位置,建议使用带有侧边目录的Gridea主题,比如 ChicNext,除此之外也还有很多。(喜欢的话不妨给作者个Star👍)。

2. 交叉引用(Cross-reference)

  熟悉$\LaTeX$的人对这个概念应该是很明白了,尽管可能难以官方描述其含义(没错,正是在下🙃)。所谓交叉引用,简单来说就是实现“跳转”。当你引用文本中其他位置的内容(标题、图片、表格等等)时,如何快速让读者“跳转”到你所说的(标记的)位置,交叉引用就是这个作用。节1中的目录原理实际上就是一种交叉引用,只不过在Markdown中这一特点被称为锚点。   那么除了目录,例如图表如何使用“锚点”呢?这些都可以通过html实现:

<a name="Mark"></a>   <!-- 在合适的位置插入这句话 -->
......
[Your text](#Mark)    <!-- 在合适的位置插入这句话 -->

  当然,需要注意的是你的锚点名不要重复,就像$\LaTeX$中的\label不能重复一样,否则就达不到想要的效果。

3. 公式

  Gridea支持$\KaTeX$公式。尽管它还不能支持所有的$\TeX$功能,但是已经是很好够用了。有些语法和$\TeX$也有出入,具体用法详见文档,同时也有表格形式便于查找命令。

4. 图片并排及增加题注

  Gridea中的图片并排实现,在网上找到的方法都没能成功。所以就想了个招:利用表格实现图片并排。但是这样一来图片外就有边框了,凑合吧☹️。为了使表格整体居中,可以在表格前后加如下代码:

<center>
    <!-- 这里空一行-->
    <!-- 你的表格-->
</center>

  单张图片增加题注时也可以利用上面的方法,在图片后加上同样的代码。但是有一点,如果你的题注中含有公式,那么就也需要在<center>后隔一行,原因也不太清楚,但是这样确实可以😶。

<center>
    <!-- 这里空一行-->
    <!-- 你的题注部分->
</center>

5. 其他

  Gridea中的Markdown渲染也支持 Sub(Subscript)、Sup(Superscript)、Abbr(Abbreviation)、Footnote。更多的Markdown语法请看这里(有些在Gridea中不支持渲染),同时我认为这也一是一份不错的学习Markdown的“资料”,简洁明了(当然,它本身就不难)。