记录一些稍微需要点精力研究的用法,方便之后回看


0. GitHub 官方文档

基本撰写和格式语法


1. 文章内跳转

1.1 标题跳转法

跳转链接(只需带1个 #):
[跳转链接文本](#标题名称)

跳转到的位置(可以是 # ## ### 等):
# 标题名称

其中 标题名称 需满足以下规则:


[跳转到 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>