本文主要是记录自己在Gridea写作时遇到的“问题”,有的时候想实现一种排版样式费尽九牛二虎之力才找到答案,特在此记录下来。顺便作为一篇
Markdown
的测试文章。在Gridea中写作时总能遇到一些问题,比如Gridea中的目录怎么显示?🤔 图片并排如何实现? 如何实现类似中的交叉引用,脚注
1. 目录(Content)
在Gridea中目录的实现可能与Markdown
的语法有所不同,语法为@[TOC]
(大小写不敏感)。另外值得一提的一点是,当文章较长时即便有目录也无法很快跳转到指定位置,建议使用带有侧边目录的Gridea主题,比如 Chic 和 Next,除此之外也还有很多。(喜欢的话不妨给作者个Star👍)。
2. 交叉引用(Cross-reference)
熟悉的人对这个概念应该是很明白了,尽管可能难以官方描述其含义(没错,正是在下🙃)。所谓交叉引用,简单来说就是实现“跳转”。当你引用文本中其他位置的内容(标题、图片、表格等等)时,如何快速让读者“跳转”到你所说的(标记的)位置,交叉引用就是这个作用。节1中的目录原理实际上就是一种交叉引用,只不过在Markdown
中这一特点被称为锚点。
那么除了目录,例如图表如何使用“锚点"呢?这些都可以通过html
实现:
<a name="Mark"></a> <!-- 在合适的位置插入这句话 -->
......
[Your text](#Mark) <!-- 在合适的位置插入这句话 -->
当然,需要注意的是你的锚点名不要重复,就像中的\label
不能重复一样,否则就达不到想要的效果。
3. 公式
Gridea支持公式。尽管它还不能支持所有的功能,但是已经是很好够用了。有些语法和也有出入,具体用法详见文档,同时也有表格形式便于查找命令。
4. 图片并排及增加题注
Gridea中的图片并排实现,在网上找到的方法都没能成功。所以就想了个招:利用表格实现图片并排。但是这样一来图片外就有边框了,凑合吧☹️。为了使表格整体居中,可以在表格前后加如下代码:
<center>
<!-- 这里空一行-->
<!-- 你的表格-->
</center>
单张图片增加题注时也可以利用上面的方法,在图片后加上同样的代码。但是有一点,如果你的题注中含有公式,那么就也需要在<center>
后隔一行,原因也不太清楚,但是这样确实可以😶。
<center>
<!-- 这里空一行-->
<!-- 你的题注部分->
</center>
5. 其他
Gridea中的Markdown
渲染也支持 Sub
(Subscript)、Sup
(Superscript)、Abbr
(Abbreviation)、Footnote
。更多的Markdown
语法请看这里(有些在Gridea中不支持渲染),同时我认为这也一是一份不错的学习Markdown
的“资料”,简洁明了(当然,它本身就不难)。