记录一些稍微需要点精力研究的用法,方便之后回看
0. GitHub 官方文档
1. 文章内跳转
1.1 标题跳转法
跳转链接(只需带1个 #
):
[跳转链接文本](#标题名称)
跳转到的位置(可以是 # ## ### 等):
# 标题名称
其中 标题名称 需满足以下规则:
- 标题文本中的空格替换为连字符 -(例如 #section 1 → #section-1)。
- 自动忽略标点符号(如 !、? 等)。
- 所有字母转换为小写(例如 #Section Two → #section-two)47。
如
[跳转到 3. Timestamp 修改文章时间](#3.-timestamp-修改文章时间)
跳转到 3. Timestamp 修改文章时间
实现跳转到后面的标题位置 # 3. Timestamp 修改文章时间
Gmeek 用不了也没必要用,忽略里面这个
1.2 自定义锚点法
通过 HTML 标签定义锚点,适用于跳转到任意位置(非标题区域)
规则
- 锚点名称需全小写,且避免使用空格和特殊字符。
- 若跳转位置在代码块或复杂格式区域,建议使用 或 包裹锚点标签
跳转链接:(带1个 #
)
[跳转链接文本](#自定义锚点名)
跳转到的位置:(不需要带 #
)
<a id="自定义锚点名"></a> 或 <span id="自定义锚点名"></span>
如
[跳转到“2. 表格”的“基础表格语法”的效果位置](#自定义锚点法)
跳转到“2. 表格”的“基础表格语法”的效果位置
实现跳转到“2. 表格”的“基础表格语法”的效果位置带代码 <a id="自定义锚点法"></a>
的地方
2. 表格
在线生成工具
TablesGenerator(可视化编辑)
基础表格语法
| 列1标题 | 列2标题 | 列3标题 |
|---------|---------|---------|
| 内容A | 内容B | 内容C |
| 内容D | 内容E | 内容F |
效果
列1标题 | 列2标题 | 列3标题 |
---|---|---|
内容A | 内容B | 内容C |
内容D | 内容E | 内容F |
对齐控制
通过 : 符号定义列对齐方式:
//文本内容本身放置靠左靠右空格哪边多都没所谓,对齐主要是靠第二行的 :
和 -
的摆法来控制
| 左对齐 | 居中对齐 | 右对齐 |
|:------------|:-------------:|------------:|
| 文本靠左 | 文本居中 | 文本靠右|
| 默认左对齐 | 可省略冒号 | 数字常用右对齐|
效果
左对齐 | 居中对齐 | 右对齐 |
---|---|---|
文本靠左 | 文本居中 | 文本靠右 |
默认左对齐 | 可省略冒号 | 数字常用右对齐 |
3. Timestamp 修改文章时间
Gmeek 作者 Meekdai 推荐使用的这段代码,放在文章末尾
<!-- ##{"timestamp":1743432646}## -->
其中内容 1743432646
为时间戳,可在时间戳转换这里按需转换
实测当文章内存在两个或以上的标题 ##
时,会产生冲突导致这段代码失效
解决方法是直接放在文章开头
应该是博客本身的一个 bug
- 建议每篇文章都生成一下这段代码,方便之后迁移或重建博客复用
4. 创建可折叠/展开的内容区块
默认折叠的区块
<details>
<summary>默认折叠的区块</summary>
这里是被折叠的内容(支持 Markdown 和 HTML)
</details>
默认展开的区块
<details open>
<summary>默认展开的区块</summary>
内容(支持 Markdown 和 HTML)
</details>