uitest
欢迎来到 尘的博客!
恭喜你发现了彩蛋这是一份 Markdown 渲染测试文档。
Quick Start
Create a new post
1 | $ hexo new "My New Post" |
More info: Writing
Run server
1 | $ hexo server |
More info: Server
Generate static files
1 | $ hexo generate |
More info: Generating
Deploy to remote sites
1 | $ hexo deploy |
More info: Deployment
1. 段落文本 p
1 | {% p 样式参数(参数以空格划分), 文本内容 %} |
- 字体: logo, code
- 颜色: red,yellow,green,cyan,blue,gray
- 大小: small, h4, h3, h2, h1, large, huge, ultra
- 对齐方向: left, center, right
- 彩色文字
在一段话中方便插入各种颜色的标签,包括:红色
、黄色
、绿色
、青色
、蓝色
、灰色
。 - 超大号文字
文档「开始」页面中的标题部分就是超大号文字。Volantis
A Wonderful Theme for Hexo
1 | - 彩色文字 |
行内文本 span
1 | {% span 样式参数(参数以空格划分), 文本内容 %} |
- 字体: logo, code
- 颜色: red,yellow,green,cyan,blue,gray
- 大小: small, h4, h3, h2, h1, large, huge, ultra
- 对齐方向: left, center, right
- 彩色文字
在一段话中方便插入各种颜色的标签,包括:红色、黄色、绿色、青色、蓝色、灰色。 - 超大号文字
文档「开始」页面中的标题部分就是超大号文字。
Volantis
A Wonderful Theme for Hexo
1 | - 彩色文字 |
行内文本样式 text
1 | {% u 文本内容 %} |
- 带 下划线 的文本
- 带
着重号 的文本 - 带
波浪线 的文本 - 带
删除线的文本 - 键盘样式的文本 command + D
- 密码样式的文本:
这里没有验证码
1 | 1. 带 {% u 下划线 %} 的文本 |
分栏 tab
1 | {% tabs Unique name, [index] %} |
- Unique name :
- 选项卡块标签的唯一名称,不带逗号。
- 将在 #id 中用作每个标签及其索引号的前缀。
- 如果名称中包含空格,则对于生成 #id,所有空格将由破折号代替。
- 仅当前帖子 / 页面的 URL 必须是唯一的!
- [index]:
- 活动选项卡的索引号。
- 如果未指定,将选择第一个标签(1)。
- 如果 index 为 - 1,则不会选择任何选项卡。
- 可选参数。
- [Tab caption]:
- 当前选项卡的标题。
- 如果未指定标题,则带有制表符索引后缀的唯一名称将用作制表符的标题。
- 如果未指定标题,但指定了图标,则标题将为空。
- 可选参数。
- [@icon]: - FontAwesome 图标名称(全名,看起来像 “ fas fa-font”) - 可以指定带空格或不带空格; - 例如’Tab caption @icon’ 和 ‘Tab caption@icon’. - 可选参数。
Demo 1 - 预设选择第一个【默认】
This is Tab 1.
This is Tab 2.
This is Tab 3.
Demo 2 - 预设选择 tabs
This is Tab 1.
This is Tab 2.
This is Tab 3.
Demo 3 - 没有预设值
This is Tab 1.
This is Tab 2.
This is Tab 3.
Demo 4 - 自定义 Tab 名 + 只有 icon + icon 和 Tab 名
tab 名字为第一个 Tab
只有图标 没有 Tab 名字
名字 + icon
Demo 1 - 预设选择第一个【默认】
1 | {% tabs test1 %} |
Demo 2 - 预设选择 tabs
1 | {% tabs test2, 3 %} |
Demo 3 - 没有预设值
1 | {% tabs test3, -1 %} |
Demo 4 - 自定义 Tab 名 + 只有 icon + icon 和 Tab 名
1 | {% tabs test4 %} |
按钮 btns
1 | {% btns 样式参数 %} |
- 圆角样式:rounded, circle
- 增加文字样式:可以在容器内增加
<b>标题</b>
和<p>描述文字</p>
- 布局方式:
默认为自动宽度,适合视野内只有一两个的情况。
参数 | 含义 |
---|---|
wide | 宽一点的按钮 |
fill | 填充布局,自动铺满至少一行,多了会换行 |
center | 居中,按钮之间是固定间距 |
around | 居中分散 |
grid2 | 等宽最多 2 列,屏幕变窄会适当减少列数 |
grid3 | 等宽最多 3 列,屏幕变窄会适当减少列数 |
grid4 | 等宽最多 4 列,屏幕变窄会适当减少列数 |
grid5 | 等宽最多 5 列,屏幕变窄会适当减少列数 |
- 如果需要显示类似「团队成员」之类的一组含有头像的链接:
- 或者含有图标的按钮:
- 圆形图标 + 标题 + 描述 + 图片 + 网格 5 列 + 居中
- 如果需要显示类似「团队成员」之类的一组含有头像的链接:
1 | {% btns circle grid5 %} |
- 或者含有图标的按钮:
1 | {% btns rounded grid5 %} |
- 圆形图标 + 标题 + 描述 + 图片 + 网格 5 列 + 居中
1 | {% btns circle center grid5 %} |
按钮 btn
1 | {% btn [url],[text],[icon],[color] [style] [layout] [position] [size] %} |
参数 | 含义 |
---|---|
url | 链接 |
text | 按钮文字 |
icon | [可选] 图标,如果开启了 fontawesome 可以使用 fontawesome 的图标,否则只能使用默内置图标 |
color | [可选] 按钮背景顔色 (默认 style 时)按钮字体和边框顔色 (outline 时) default/blue/pink/red/purple/orange/green |
style | [可选] 按钮样式 默认实心数,outline / 留空 |
layout | [可选] 按钮佈局 默认为 line block / 留空 |
position | [可选] 按钮位置 前提是设置了 layout 为 block 默认为左边 center/right/留空数 |
size | [可选] 按钮大小 larger / 留空 |
- 一组按钮
This is my website, click the button AnZhiYu
This is my website, click the button AnZhiYu
This is my website, click the button AnZhiYu
This is my website, click the button AnZhiYu
This is my website, click the button AnZhiYu
- 调整位置 / 大小
- more than one button in center
- 居中按钮
- 一组按钮
1 | This is my website, click the button {% btn 'https://anheyu.com/',AnZhiYu %} |
- 调整位置 / 大小
1 | {% btn 'https://anheyu.com/',AnZhiYu,anzhiyufont anzhiyu-icon-circle-arrow-right,block %} |
- more than one button in center
1 | <span> |
- 居中按钮
1 | <div class="btn-center"> |
网站卡片 sites
1 | {% sitegroup %} |
1 | {% sitegroup %} |
单张图片 image
1 | {% image 链接, width=宽度(可选), height=高度(可选), alt=描述(可选), bg=占位颜色(可选) %} |
- 图片宽度高度:width = 300px, height = 32px
- 图片描述:alt = 图片描述(butterfly 需要在主题配置文件中开启图片描述)
- 占位背景色:bg=#f2f2f2
- 添加描述:
- 指定宽度:
- 指定宽度并添加描述:
- 设置占位背景色:
- 添加描述:
1 | {% image https://blog.bornforthis.cn/img/posts/02-anzhiyu-theme-tag/6478937d7de6f.webp, alt=每天下课回宿舍的路,没有什么故事。 %} |
- 指定宽度:
1 | {% image https://blog.bornforthis.cn/img/posts/02-anzhiyu-theme-tag/6478937d7de6f.webp, width=400px %} |
- 指定宽度并添加描述:
1 | {% image https://blog.bornforthis.cn/img/posts/02-anzhiyu-theme-tag/6478937d7de6f.webp, width=400px, alt=每天下课回宿舍的路,没有什么故事。 %} |
- 设置占位背景色:
1 | {% image https://blog.bornforthis.cn/img/posts/02-anzhiyu-theme-tag/6478937d7de6f.webp, width=400px, bg=#1D0C04, alt=优化不同宽度浏览的观感 %} |
inlineImg 行内图片
1 | {% inlineImg [src] [height] %} |
参数 | 含义 |
---|---|
src | 图片链接 |
height | 图片高度限制【可选】 |
你看我长得漂亮不
我觉得很漂亮
1 | 你看我长得漂亮不 |
行内图片 inlineimage
1 | {% inlineimage 图片链接, height=高度(可选) %} |
- 高度:height = 20px
这是 一段话。
这又是 一段话。
1 | 这是 {% inlineimage https://blog.bornforthis.cn/img/posts/02-anzhiyu-theme-tag/647895232e5d5.webp %} 一段话。 |
label 标签
1 | {% label text color %} |
参数 | 含义 |
---|---|
text | 文字 |
color | 【可选】背景颜色,默认为 default,default/blue/pink/red/purple/orange/green |
臣亮言:先帝 创业未半,而中道崩殂 。今天下三分,益州疲敝 ,此诚危急存亡之秋 也!然侍衞之臣,不懈于内;忠志之士 ,忘身于外者,盖追先帝之殊遇,欲报之于陛下也。诚宜开张圣听,以光先帝遗德,恢弘志士之气;不宜妄自菲薄,引喻失义,以塞忠谏之路也。
宫中、府中,俱为一体;陟罚臧否,不宜异同。若有作奸 、犯科 ,及为忠善者,宜付有司,论其刑赏,以昭陛下平明之治;不宜偏私,使内外异法也。
1 | 臣亮言:{% label 先帝 %}创业未半,而{% label 中道崩殂 blue %}。今天下三分,{% label 益州疲敝 pink %},此诚{% label 危急存亡之秋 red %}也!然侍衞之臣,不懈于内;{% label 忠志之士 purple %},忘身于外者,盖追先帝之殊遇,欲报之于陛下也。诚宜开张圣听,以光先帝遗德,恢弘志士之气;不宜妄自菲薄,引喻失义,以塞忠谏之路也。 |
timeline
1 | {% timeline title,color %} |
参数 | 含义 |
---|---|
title | 标题 / 时间线 |
color | timeline 颜色,default (留空) / blue / pink / red / purple / orange / green |
默认颜色
2022
01-02
这是测试页面
blue
2022
01-02
这是测试页面
pink
2022
01-02
这是测试页面
red
2022
01-02
这是测试页面
purple
2022
01-02
这是测试页面
orange
2022
01-02
这是测试页面
green
2022
01-02
这是测试页面
- 默认颜色
1 | {% timeline 2022 %} |
- blue
1 | {% timeline 2022,blue %} |
- pink
1 | {% timeline 2022,pink %} |
- red
1 | {% timeline 2022,red %} |
- purple
1 | {% timeline 2022,purple %} |
- orange
1 | {% timeline 2022,orange %} |
- green
1 | {% timeline 2022,green %} |
flink 友链标签
1 | {% flink %} |
参数 | 含义 |
---|---|
class_name | h2 标题 |
flink_style | 【可选】友链样式,默认为 flexcard,flexcard / anzhiyu |
link_list | 【可选】友链样式,默认为 flexcard,flexcard / anzhiyu |
1 |
|
mermaid 图
修改 主题配置文件
1 | # mermaid |
1 | {% mermaid %} |
1 | {% mermaid %} |
复选列表 checkbox
1 | {% checkbox 样式参数(可选), 文本(支持简单md) %} |
- 样式: plus, minus, times
- 颜色: red,yellow,green,cyan,blue,gray
- 选中状态: checked
1 | {% checkbox 纯文本测试 %} |
dogeplayer 多吉云播放器
1 | {% dogeplayer 4945 ebb742fd1f0b5a7b %} |
获取userId
与vcode
参数 | 含义 |
---|---|
userId | 多吉云 userId |
vcode | 视频 vcode |
1 | {% dogeplayer 4945 ebb742fd1f0b5a7b %} |
折叠框 folding
1 | {% folding 参数(可选), 标题 %} |
- 颜色:blue, cyan, green, yellow, red
- 状态:状态填写 open 代表默认打开。
查看图片测试
查看默认打开的折叠框
这是一个默认打开的折叠框。
查看代码测试
1 |  |
查看列表测试
- haha
- hehe
查看嵌套测试
查看嵌套测试 2
查看嵌套测试 3
hahaha
1 | {% folding 查看图片测试 %} |
Gallery 相册图库
一个图库集合。
gallerygroup 相册图库
1
2
3
4
5<div class="gallery-group-main">
{% galleryGroup name description link img-url %}
{% galleryGroup name description link img-url %}
{% galleryGroup name description link img-url %}
</div>gallery 相册
1 | {% gallery %} |
参数名 | 释义 |
---|---|
lazyload | 【可选】点击按钮加载更多图片,填写 true / false。默认为 false 。 |
rowHeight | 【可选】图片显示的高度,如果需要一行显示更多的图片,可设置更小的数字。默认为 220 。 |
limit | 【可选】每次加载多少张照片。默认为 10 。 |
1 | {% gallery url,[link],[lazyload],[rowHeight],[limit] %} |
参数名 | 释义 |
---|---|
url | 【必须】 识别词 |
link | 【必须】远程的 json 链接 |
lazyload | 【可选】点击按钮加载更多图片,填写 true / false。默认为 false 。 |
rowHeight | 【可选】图片显示的高度,如果需要一行显示更多的图片,可设置更小的数字。默认为 220 。 |
limit | 【可选】每次加载多少张照片。默认为 10 。 |
远程链接 Json 的例子
有三个参数,url
是必须存在的,alt
和 title
可有,也可没有。
1 | [ |
示例
1 | {% gallery url,https://xxxx.com/sss.json %} |
gallerygroup 相册图库
参数名 释义 name 图库名字 description 图库描述 link 链接到对应相册的地址 img-url 图库封面
思维拓展一下,相册图库的实质其实就是个快捷方式,可以自定义添加描述、封面、链接。那么我们未必要把它当做一个相册,完全可以作为一个链接卡片,链接到视频、QQ、友链都是不错的选择。
- gallery 相册
区别于旧版的 Gallery 相册, 新的 Gallery 相册会自动根据图片长度进行排版,书写也更加方便,与 markdown 格式一样。可根据需要插入到相应的 md。无需再自己配置长宽。建议在粘贴时故意使用长短、大小、横竖不一的图片,会有更好的效果。(尺寸完全相同的图片只会平铺输出,效果很糟糕)
1 | {% gallery %} |
参数名 | 释义 |
---|---|
lazyload | 【可选】点击按钮加载更多图片,填写 true / false。默认为 false 。 |
rowHeight | 【可选】图片显示的高度,如果需要一行显示更多的图片,可设置更小的数字。默认为 220 。 |
limit | 【可选】每次加载多少张照片。默认为 10 。 |
1 | {% gallery url,[link],[lazyload],[rowHeight],[limit] %} |
参数名 | 释义 |
---|---|
url | 【必须】 识别词 |
link | 【必须】远程的 json 链接 |
lazyload | 【可选】点击按钮加载更多图片,填写 true / false。默认为 false 。 |
rowHeight | 【可选】图片显示的高度,如果需要一行显示更多的图片,可设置更小的数字。默认为 220 。 |
limit | 【可选】每次加载多少张照片。默认为 10 。 |
远程链接 Json 的例子
有三个参数,url
是必须存在的,alt
和 title
可有,也可没有。
1 | [ |
示例
1 | {% gallery url,https://xxxx.com/sss.json %} |
- gallerygroup 相册图库
- gallery 相册
对于很多同学提问的gallerygroup
和gallery
相册页的链接问题。这里说下我个人的使用习惯。
一般使用相册图库的话,可以在导航栏加一个 gallery 的 page (使用指令hexo new page gallery
添加),里面放相册图库作为封面。然后在[Blogroot]/source/gallery/
下面建立相应的文件夹,例如若按照这里的示例,若欲使用/gallery/MC/
路径访问 MC 相册,则需要新建[Blogroot]/source/gallery/MC/index.md
,并在里面填入gallery
相册内容。
注意 ⚠️:本站相册集为单独优化,可参考配置相册页面。
gallerygroup 相册图库
1
2
3
4
5<div class="gallery-group-main">
{% galleryGroup MC 在Rikkaの六花服务器里留下的足迹 '/wordScenery/' https://blog.bornforthis.cn/img/posts/02-anzhiyu-theme-tag/64788f24d05bd.webp %}
{% galleryGroup Gundam 哦咧哇gundam哒! '/thousand/' https://blog.bornforthis.cn/img/posts/02-anzhiyu-theme-tag/64788f456fc3d.webp %}
{% galleryGroup I-am-Akilar 某种意义上也算自拍吧 '/wallpaper/' https://blog.bornforthis.cn/img/posts/02-anzhiyu-theme-tag/64788f83e5fa1.webp %}
</div>gallery 相册
1
2
3
4
5
6
7
8
9
10{% gallery true,,2 %}








{% endgallery %}
tag-hide
inline
在文本里面添加按钮隐藏内容,只限文字
( content 不能包含英文逗号,可用‚
)
1 | {% hideInline content,display,bg,color %} |
content: 文本内容
display: 按钮显示的文字 (可选)
bg: 按钮的背景颜色 (可选)
color: 按钮文字的颜色 (可选)
Demo
1 | 哪个英文字母最酷? {% hideInline 因为西装裤(C装酷),查看答案,#FF7242,#fff %} |
哪个英文字母最酷?
门里站着一个人?
block
独立的 block 隐藏内容,可以隐藏很多内容,包括图片,代码块等等
( display 不能包含英文逗号,可用‚
)
1 | {% hideBlock display,bg,color %} |
content: 文本内容
display: 按钮显示的文字 (可选)
bg: 按钮的背景颜色 (可选)
color: 按钮文字的颜色 (可选)
Demo
1 | 查看答案 |
查看答案
如果你需要展示的内容太多,可以把它隐藏在收缩框里,需要时再把它展开。
( display 不能包含英文逗号,可用‚
)
1 | {% hideToggle display,bg,color %} |
Demo
AnZhiYu 主题安装方法
在你的博客根目录里
git clone -b master https://github.com/anzhiyu-c/hexo-theme-anzhiyu.git themes/anzhiyu
如果想要安装比较新的 dev 分支,可以
git clone -b dev https://github.com/anzhiyu-c/hexo-theme-anzhiyu.git themes/anzhiyu
链接卡片 link
1 | {% link 标题, 站点描述, 链接, 图片链接(可选) %} |
1 | {% link 获取网站的Favicon图标并显示在你的网页上,owen0o0,https://github.com/owen0o0/getFavicon %} |
单选列表 radio
1 | {% radio 样式参数(可选), 文本(支持简单md) %} |
- 颜色: red,yellow,green,cyan,blue,gray
- 选中状态: checked
1 | {% radio 纯文本测试 %} |
上标标签 tip
主要样式参考自小康的 butterfly 渐变背景标签
1 | {% tip [参数,可选] %}文本内容{% endtip %} |
- 样式: success,error,warning,bolt,ban,home,sync,cogs,key,bell
- 自定义图标: 支持 fontawesome。
default
info
success
error
warning
bolt
ban
home
sync
cogs
key
bell
自定义 font awesome 图标
1 | {% tip %}default{% endtip %} |
Note (Bootstrap Callout)
修改主题配置文件
1 | note: |
Note
标签外挂有两种用法。icons
和light_bg_offset
只对方法一生效。
fontawesome
图标需开启主题配置文件中icons.fontawesome
方法一
1 | {% note [class] [no-icon] [style] %} |
方法二
1 | {% note [color] [icon] [style] %} |
方法一
参数 | 用法 |
---|---|
class | 【可选】标识,不同的标识有不同的配色 ( default / primary / success / info / warning / danger ) |
no-icon | 【可选】不显示 icon |
style | 【可选】可以覆盖配置中的 style (simple/modern/flat/disabled) |
方法二
参数 | 用法 |
---|---|
class | 【可选】标识,不同的标识有不同的配色 ( default / blue / pink / red / purple / orange / green ) |
no-icon | 【可选】可配置自定义 icon (支持 fontawesome 图标和主题内置的阿里图标,fontawesome 图标需开启主题配置文件中icons.fontawesome , 也可以配置 no-icon ) |
style | 【可选】可以覆盖配置中的 style (simple/modern/flat/disabled) |
方法一
simple
样式
默认 提示块标签
default 提示块标签
primary 提示块标签
success 提示块标签
info 提示块标签
warning 提示块标签
danger 提示块标签
modern
样式
默认 提示块标签
default 提示块标签
primary 提示块标签
success 提示块标签
info 提示块标签
warning 提示块标签
danger 提示块标签
flat
样式
默认 提示块标签
default 提示块标签
primary 提示块标签
success 提示块标签
info 提示块标签
warning 提示块标签
danger 提示块标签
disabled
样式
默认 提示块标签
default 提示块标签
primary 提示块标签
success 提示块标签
info 提示块标签
warning 提示块标签
danger 提示块标签
no-icon
样式
方法二
图标支持 fontawesome
和 主题内置的阿里图标
,使用方法为加上对应的类名,fontawesome
图标需开启主题配置文件中icons.fontawesome
,默认未开启 fontawesome
- simple 样式
主题内置阿里图标
fontawesome 图标
,开启主题配置文件中的icons.fontawesome
为true
后可见
你是刷 Visa 还是 UnionPay
2022 年快到了….
小心开车 安全至上
这是三片呢?还是四片?
你是刷 Visa 还是 UnionPay
剪刀石头布
前端最讨厌的浏器
- modern 样式
主题内置阿里图标
fontawesome 图标
,开启主题配置文件中的icons.fontawesome
为true
后可见
你是刷 Visa 还是 UnionPay
2021 年快到了….
小心开车 安全至上
这是三片呢?还是四片?
你是刷 Visa 还是 UnionPay
剪刀石头布
前端最讨厌的浏览器
- flat 样式
主题内置阿里图标
fontawesome 图标
,开启主题配置文件中的icons.fontawesome
为true
后可见
你是刷 Visa 还是 UnionPay
2021 年快到了….
小心开车 安全至上
这是三片呢?还是四片?
你是刷 Visa 还是 UnionPay
剪刀石头布
前端最讨厌的浏览器
- disabled 样式
主题内置阿里图标
fontawesome 图标
,开启主题配置文件中的icons.fontawesome
为true
后可见
你是刷 Visa 还是 UnionPay
2021 年快到了….
小心开车 安全至上
这是三片呢?还是四片?
你是刷 Visa 还是 UnionPay
剪刀石头布
前端最讨厌的浏览器
- no-icon 样式
方法一
simple
样式
1 | {% note simple %}默认 提示块标签{% endnote %} |
modern
样式
1 | {% note modern %}默认 提示块标签{% endnote %} |
flat
样式
1 | {% note flat %}默认 提示块标签{% endnote %} |
disabled
样式
1 | {% note disabled %}默认 提示块标签{% endnote %} |
no-icon
样式
1 | {% note no-icon %}默认 提示块标签{% endnote %} |
方法二
图标支持 fontawesome
和 主题内置的阿里图标
,使用方法为加上对应的类名,fontawesome
图标需开启主题配置文件中icons.fontawesome
,默认未开启 fontawesome
simple 样式
主题内置阿里图标
1
2
3
4
5
6
7{% note 'anzhiyufont anzhiyu-icon-rocket' simple %}你是刷 Visa 还是 UnionPay{% endnote %}
{% note blue 'anzhiyufont anzhiyu-icon-bullhorn' simple %}2022 年快到了....{% endnote %}
{% note pink 'anzhiyufont anzhiyu-icon-instagram' simple %}小心开车 安全至上{% endnote %}
{% note red 'anzhiyufont anzhiyu-icon-fan' simple%}这是三片呢?还是四片?{% endnote %}
{% note orange 'anzhiyufont anzhiyu-icon-dengpao' simple %}你是刷 Visa 还是 UnionPay{% endnote %}
{% note purple 'anzhiyufont anzhiyu-icon-sanmingzhi' simple %}剪刀石头布{% endnote %}
{% note green 'anzhiyufont anzhiyu-icon-ic_train' simple %}前端最讨厌的浏览器{% endnote %}fontawesome 图标
,开启主题配置文件中的icons.fontawesome
为true
后可见1
2
3
4
5
6
7{% note 'fab fa-cc-visa' simple %}你是刷 Visa 还是 UnionPay{% endnote %}
{% note blue 'fas fa-bullhorn' simple %}2022 年快到了....{% endnote %}
{% note pink 'fas fa-car-crash' simple %}小心开车 安全至上{% endnote %}
{% note red 'icon-fan' simple%}这是三片呢?还是四片?{% endnote %}
{% note orange 'fas fa-battery-half' simple %}你是刷 Visa 还是 UnionPay{% endnote %}
{% note purple 'far fa-hand-scissors' simple %}剪刀石头布{% endnote %}
{% note green 'fab fa-internet-explorer' simple %}前端最讨厌的浏览器{% endnote %}modern 样式
主题内置阿里图标
1
2
3
4
5
6
7{% note 'anzhiyufont anzhiyu-icon-rocket' modern %}你是刷 Visa 还是 UnionPay{% endnote %}
{% note blue 'anzhiyufont anzhiyu-icon-bullhorn' modern %}2022 年快到了....{% endnote %}
{% note pink 'anzhiyufont anzhiyu-icon-instagram' modern %}小心开车 安全至上{% endnote %}
{% note red 'anzhiyufont anzhiyu-icon-fan' modern%}这是三片呢?还是四片?{% endnote %}
{% note orange 'anzhiyufont anzhiyu-icon-dengpao' modern %}你是刷 Visa 还是 UnionPay{% endnote %}
{% note purple 'anzhiyufont anzhiyu-icon-sanmingzhi' modern %}剪刀石头布{% endnote %}
{% note green 'anzhiyufont anzhiyu-icon-ic_train' modern %}前端最讨厌的浏览器{% endnote %}fontawesome 图标
,开启主题配置文件中的icons.fontawesome
为true
后可见1
2
3
4
5
6
7{% note 'fab fa-cc-visa' modern %}你是刷 Visa 还是 UnionPay{% endnote %}
{% note blue 'fas fa-bullhorn' modern %}2021 年快到了....{% endnote %}
{% note pink 'fas fa-car-crash' modern %}小心开车 安全至上{% endnote %}
{% note red 'icon-fan' modern%}这是三片呢?还是四片?{% endnote %}
{% note orange 'fas fa-battery-half' modern %}你是刷 Visa 还是 UnionPay{% endnote %}
{% note purple 'far fa-hand-scissors' modern %}剪刀石头布{% endnote %}
{% note green 'fab fa-internet-explorer' modern %}前端最讨厌的浏览器{% endnote %}flat 样式
主题内置阿里图标
1
2
3
4
5
6
7{% note 'anzhiyufont anzhiyu-icon-rocket' flat %}你是刷 Visa 还是 UnionPay{% endnote %}
{% note blue 'anzhiyufont anzhiyu-icon-bullhorn' flat %}2022 年快到了....{% endnote %}
{% note pink 'anzhiyufont anzhiyu-icon-instagram' flat %}小心开车 安全至上{% endnote %}
{% note red 'anzhiyufont anzhiyu-icon-fan' flat%}这是三片呢?还是四片?{% endnote %}
{% note orange 'anzhiyufont anzhiyu-icon-dengpao' flat %}你是刷 Visa 还是 UnionPay{% endnote %}
{% note purple 'anzhiyufont anzhiyu-icon-sanmingzhi' flat %}剪刀石头布{% endnote %}
{% note green 'anzhiyufont anzhiyu-icon-ic_train' flat %}前端最讨厌的浏览器{% endnote %}fontawesome 图标
,开启主题配置文件中的icons.fontawesome
为true
后可见1
2
3
4
5
6
7{% note 'fab fa-cc-visa' flat %}你是刷 Visa 还是 UnionPay{% endnote %}
{% note blue 'fas fa-bullhorn' flat %}2021 年快到了....{% endnote %}
{% note pink 'fas fa-car-crash' flat %}小心开车 安全至上{% endnote %}
{% note red 'icon-fan' flat%}这是三片呢?还是四片?{% endnote %}
{% note orange 'fas fa-battery-half' flat %}你是刷 Visa 还是 UnionPay{% endnote %}
{% note purple 'far fa-hand-scissors' flat %}剪刀石头布{% endnote %}
{% note green 'fab fa-internet-explorer' flat %}前端最讨厌的浏览器{% endnote %}disabled 样式
主题内置阿里图标
1
2
3
4
5
6
7{% note 'anzhiyufont anzhiyu-icon-rocket' disabled %}你是刷 Visa 还是 UnionPay{% endnote %}
{% note blue 'anzhiyufont anzhiyu-icon-bullhorn' disabled %}2022 年快到了....{% endnote %}
{% note pink 'anzhiyufont anzhiyu-icon-instagram' disabled %}小心开车 安全至上{% endnote %}
{% note red 'anzhiyufont anzhiyu-icon-fan' disabled%}这是三片呢?还是四片?{% endnote %}
{% note orange 'anzhiyufont anzhiyu-icon-dengpao' disabled %}你是刷 Visa 还是 UnionPay{% endnote %}
{% note purple 'anzhiyufont anzhiyu-icon-sanmingzhi' disabled %}剪刀石头布{% endnote %}
{% note green 'anzhiyufont anzhiyu-icon-ic_train' disabled %}前端最讨厌的浏览器{% endnote %}fontawesome 图标
,开启主题配置文件中的icons.fontawesome
为true
后可见1
2
3
4
5
6
7{% note 'fab fa-cc-visa' disabled %}你是刷 Visa 还是 UnionPay{% endnote %}
{% note blue 'fas fa-bullhorn' disabled %}2021 年快到了....{% endnote %}
{% note pink 'fas fa-car-crash' disabled %}小心开车 安全至上{% endnote %}
{% note red 'icon-fan' disabled %}这是三片呢?还是四片?{% endnote %}
{% note orange 'fas fa-battery-half' disabled %}你是刷 Visa 还是 UnionPay{% endnote %}
{% note purple 'far fa-hand-scissors' disabled %}剪刀石头布{% endnote %}
{% note green 'fab fa-internet-explorer' disabled %}前端最讨厌的浏览器{% endnote %}no-icon 样式
1
2
3
4
5
6
7{% note no-icon %}你是刷 Visa 还是 UnionPay{% endnote %}
{% note blue no-icon %}2021 年快到了....{% endnote %}
{% note pink no-icon %}小心开车 安全至上{% endnote %}
{% note red no-icon %}这是三片呢?还是四片?{% endnote %}
{% note orange no-icon %}你是刷 Visa 还是 UnionPay{% endnote %}
{% note purple no-icon %}剪刀石头布{% endnote %}
{% note green no-icon %}前端最讨厌的浏览器{% endnote %}
音频 audio
1 | {% audio 音频链接 %} |
1 | {% audio https://blog.bornforthis.cn/img/posts/02-anzhiyu-theme-tag/%E9%9D%92%E8%8A%B1%E7%93%B7.mp3 %} |
视频 video
1 | {% video 视频链接 %} |
- 对其方向:left, center, right
- 列数:逗号后面直接写列数,支持 1 ~ 4 列。
- 100% 宽度
- 50% 宽度
- 25% 宽度
- 100% 宽度
1 | {% video https://blog.bornforthis.cn/img/posts/02-anzhiyu-theme-tag/IMG_0341.mov %} |
- 50% 宽度
1 | {% videos, 2 %} |
- 25% 宽度
1 | {% videos, 4 %} |
【提示:Github 中 Front-matter 以表格形式显示】
简介
文章使用方法
这原本是一篇 Typora 下使用 Markdown 语法的案例实践分享,最早创建于 2021 年 11 月之前,于 2023 年 6 月大改。本篇文章使用 Markdown 标记语法编写而成,汇聚了常用 Markdown 语法标注。对于不同目标人群有不同的作用:
- 对于 Markdown 学习者。可以获取文章源码(Github 仓库地址在下面),并使用你的本地编辑器打开。通过对比标记语言与渲染结果直接学习。如果你不喜欢这种 MarkDown 学习方式,你可以参考 GitHub 学习相关 Markdown 规范:基本撰写和格式语法 - GitHub 文档
- 对于其他人。这篇文章包含不同标准 Markdown 语法,你可以在任何 Markdown 编辑器打开以测试其渲染效果。
- 比如说 —— 你。你使用什么方式看到这篇文章,就了解到你所用的软件对 Markdown 语言的支持情况。如果你通过我的博客打开,那么你看到的就是 Hexo 渲染后的结果(至少目前时是这样)。
- 比如说 —— 我,笔记重度依赖。我需要对比本地编辑器的渲染器与 Hexo 各类渲染器和插件对 Markdown 的支持程度,以培养合适的写作习惯,加强核心工作流的可移植性。
文章目前可预览的在线版本:
- Hexo 渲染网页:Markdown 渲染测试 | 半方池水半方田 (uuanqin.top)。源文件直接通过 Hexo 渲染生成的静态网页。
- Github 仓库: https://github.com/uuanqin/Markdown-Grammar-Rendering-Test 。源文件的副本,不定期与 Hexo 本地同步。
Markdown 标准
约翰・格鲁伯在 2004 年创造了 Markdown 语言,Daring Fireball: Markdown。格鲁伯认为不应完全标准化:「不同的网站(和人们)有不同的需求。没有一种语法可以让所有人满意。[^satisfy]」
[^satisfy]: Markdown - 维基百科,自由的百科全书 (wikipedia.org)
下文将从 Commonmark、GFM 为基础分板块进行 Markdown 渲染测试。
此外,对一些 Markdown 编辑器语法进行展示。其中,本文使用的 Typora 版本为 1.8.10,Obsidian 版本为 1.6.7。
基础(CommonMark)
这一部分测试 Markdown 基础语法,参考自 CommonMark。这部分内容的成功渲染(除了下面的段落部分)是本文结构不至于散乱的基础(比如上文的标题、超链接、列表等的正确渲染)。
(第一段)这是一个很长很长很长很长的段落。
只有隔一个空行才能分锻,有点像 Latex。
在 CommonMark 语法中这三句话是一长句的。
【提示】在 Typora、Obsidian 中是换行了,这样做是有好处的。
(第二段)这是一个很长很长很长很长的段落。
与上一段之间隔了一个空行。
(第三段)这是一个很长很长很长很长的段落。\
反斜杠也能起到换行的作用。\
【提示】Typora、Obsidian 不需要这个符号,这样做会很方便。
一级标题(类 Atx 形式)
二级标题(类 Atx 形式)
三级标题(类 Atx 形式)
一级标题(类 Setext 形式)
二级标题(类 Setext 形式)
【提示】Obsidian 支持类 Setext 形式的标题,请在浏览模式下查看。
斜体(星号表示) 斜体(下划线表示)
粗体(星号表示) 粗体(下划线表示)
引言
二级引言
引言
- 无序列表 使用横线
- 无序列表 使用星号
- 有序列表 使用数字加点
- 有序列表 使用数字加右括号
【提示】Obsidian 中有序列表有区别。
网状列表
- 元素 1
- 元素 2
网状列表
- 使用横线
- 使用星号
链接悬停提示写法:Title
【提示】Obsidian 在浏览模式下正常,在编辑模式有点迷惑,这是由它们的链接特色决定的。
行内代码 Inline Code
行内代码(单个反引号包裹)
1 | # 代码块(三个反引号包裹) |
代码块(四个空格开头)
代码块(紧挨上一行)
【提示】Obsidian 这里的代码块在浏览模式下没有区别
减号式下划线:
星号式下划线:
GitHub Flavored Markdown(GFM)
GitHub Flavored Markdown, often shortened as GFM, is the dialect of Markdown that is currently supported for user content on GitHub.com and GitHub Enterprise.
基本格式语法
这里只介绍 基本撰写和格式语法 - GitHub 文档 提及的规范。
与 CommonMark 对比新增了以下语法:
支持四级标题(类 Atx 形式,井号方式)
支持五级标题(类 Atx 形式,井号方式)
支持六级标题(类 Atx 形式,井号方式)
删除线(两条波浪线)
粗体和嵌入 _ 斜体 _ 两个星号内下划线括住。【提示】Obsidian 支持内嵌斜体,请在浏览模式打开。
全部粗体和斜体(三个星号)
使用下标
使用上标
- 加号创建的无序列表
任务列表展示:
- 任务列表
- 任务列表
表情符号(使用冒号括住) :+1: :smile:【提示】Obsidian 不支持,但是可以直接输入😯
脚注。使用此括号 [^11] 语法为您的内容 [^12] 添加脚注。
[^11]: My reference.
[^12]: To add line breaks within a footnote, prefix new lines with 2 spaces.
This is a second line. (然而 Typora 不支持这种方式换行)
【提示】Obsidian 会把脚注自动放到页面后。
支持转义符(反引号)忽略 Markdown 格式。
以下符号可以转义(Daring Fireball: Markdown Syntax Documentation)
\ backslash
` backtick
* asterisk
_ underscore
{} curly braces
[] square brackets
() parentheses
支持 Markdown 的隐藏渲染:
【提示】Typora 处理仅仅是标黄,Obsidian 支持。
高级格式
如果你正在使用 Typora 预览,建议打开偏好设置调整以支持更多语法。
表格
表格末尾的竖线可选。单元格的宽度可以不同,无需在列内准确对齐。 标题行的第一列中必须至少有三个横线。可借助 在线表格生成工具 生成表格。
可以在表格中使用格式,例如链接、内联代码块和文本样式。
First Header | Second Header |
---|---|
Content Cell | Content Cell |
Content Cell | Content Cell |
Content Cell |
Content Cell |
可以通过在标题行中连字符的左侧、右侧或两侧添加冒号 :
,来靠左、靠右或居中对齐列中的文本。
若要包含竖线 |
作为单元格中的内容,请在竖线前使用 \
Left-aligned | Center-aligned | Right-aligned |
---|---|---|
git status | git status | git status |
git diff | ` | git diff | |
折叠部分
【提示】Typora ,Obsidian 不支持。
代码块
要在围栏代码块中显示三重倒引号,请将其包在四个倒引号内。
1 | ``` |
支持语法高亮(使用 github-linguist/linguist: Language Savant. )
1 | def main(): |
使用代码块在 Markdown 中创建关系图。 GitHub 支持 Mermaid、GeoJSON、TopoJSON 和 ASCII STL 语法。
Mermaid 是一款受 Markdown 启发的工具,可将文本呈现为关系图。 例如,Mermaid 可以呈现流程图、序列图、饼图等。 有关详细信息,请参阅 Mermaid 文档。如果你的 Markdown 渲染器支持渲染的话,你应该看到下面流程图。
1 | graph TD; |
可使用 GeoJSON 或 TopoJSON 语法创建交互式地图。 若要创建地图,请使用 geojson
或 topojson
语法标识符在围栏代码块中添加 GeoJSON 或 TopoJSON。如果你的 Markdown 渲染器支持渲染的话,你应该看到下面两幅图。
1 | { |
1 | { |
GFM 可以直接在 Markdown 中使用 ASCII STL 语法来创建交互式 3D 模型。 若要显示模型,请使用 stl
语法标识符在围栏代码块中添加 ASCII STL 语法。如果你的 Markdown 渲染器支持渲染的话,应该看到一个立方体而不是代码块。
1 | solid cube_corner |
【提示】Typora、Obsidian 不支持 geojson
、 topojson
或 ASCII STL
语法。
数学表达式
内联表达式:This sentence uses $
delimiters to show math inline: $\sqrt{3x-1}+(1+x)^2$
要以块的形式添加数学表达式,请启动一个新行,并使用两个美元符号 $$
分隔表达式。
$$
\left( \sum_{k=1}^n a_k b_k \right)^2 \leq \left( \sum_{k=1}^n a_k^2 \right) \left( \sum_{k=1}^n b_k^2 \right)
$$
或者,可以使用 math
代码块语法将数学表达式显示为块。 使用此语法时,无需使用 $$
分隔符。【提示】Typora、Obsidian 不支持。
1 | \sqrt{3} |
表示美元符号:
- 在数学表达式内,在显式
$
之前添加一个\
符号。- This expression uses
\$
to display a dollar sign: $\sqrt{$4}$
- This expression uses
- 在数学表达式之外,但在同一行上,在显式
$
两边使用 span 标记。- To split $100 in half, we calculate $100/2$
- 【提示】Typora 不支持。
如果你还想学习更多,请看 GitHub Flavored Markdown Spec
在网页上以文本的形式展示数学公式,只需要一个 LaTeX 的子集能渲染数学公式即可。KaTeX 就是这样一个支持 HTML 的轻量级的数学公式引擎。因此,在网页中编写数学公式应注意使用兼容性更广的语法。
Typora
Typora 使用 GFM,其特色在于 “WYSIWYG”,其有自己特色的语法渲染。
使用类 Setext 形式 (Setext - Wikipedia) 创建标题。注意使用 Shift + Enter 换行。(有线)
使用类 Atx 形式创建标题,一共可以有 6 个级别。(井号)
使用 [TOC]
创建目录:
[TOC]
分割线使用三个以上符号(最后一个使用了标签)。符号中间可以插入空格。
Esc
段落的换行是使用两个以上的空格加回车(在 Typora 编辑器里是 Shift+Enter)
或者使用 HTML 标签
进行换行
不要吝惜回车,在一些情况下回车会被吞掉!
代码块内还能高亮:
1 | Here's an example: |
Typora now supports YAML Front Matter. Input ---
at the top of the article and then press Return
to introduce a metadata block. Alternatively, you can insert a metadata block from the top menu of Typora. 这里就不演示了哈,弄 Hexo 的喜闻乐见。
支持有标题的 Link,试试鼠标停留在上面:an example
Typora allows you to insert URLs as links, wrapped by <
brackets>
.
<i@typora.io>
becomes i@typora.io.
Typora will also automatically link standard URLs. e.g: www.google.com. 就是没有任何标记也解析出地址了。
Underline is powered by raw HTML.
支持下划线:<u>下划线</u>
becomes 下划线.
支持上下标(在偏好设置中设置):H2O X^2^
支持高亮:==highlight==
Obsidian Flavored Markdown(OFM)
Obsidian 是一个基于 Markdown 进行记录的知识库软件,特点在于支持笔记的双向链接。因此,有自己的独特语法。
Obsidian 努力让 Obsidian 的语法不偏离正统的 Markdown 语法太多。总的来看,Obsidian 的语法大多还是基于 CommonMark,包括了一些 GitHub Flavored Markdown(GFM)和 LaTeX,以及 Obsidian 特有的语法。
Syntax | Description |
---|---|
[[ ]] | Internal links |
![[ ]] | Embedding files |
%% |
Comments |
> [!note] |
Callouts |
提示:为防止其他插件影响,Embedding files 的示例含转义字符。
Obsidian doesn’t support Markdown syntax or blank lines within HTML blocks.
参考:
Internal links 内部链接
通过 [[ ]] 来链接库中任意一个文件。
链接一篇笔记:例如 [[双链渲染测试]]。
你可以将图片或者音频等附件嵌入到你的笔记中。嵌入文件的语法为 ![[文件名.png]]
你可以通过相同的语法将 PDF 文件嵌入到你的笔记中。除此之外,你可以通过 ![[My File.pdf#page=number]] 这样的形式直接指定嵌入 PDF 文件的页码。
由于 Markdown 兼容 HTML,因此你可以使用 “iframe” 将网页嵌入到笔记中。
这个语法实际受到了 Markdown 相关语法的启发:
- 在 Markdown 中,[Image](link.png) 可以让链接指向图片,而  能让图片嵌入到当前文档中。
- 而 内部链接 的语法则基于以下设定:[[My page]] 是 [My page](My page) 的一个便捷写法(或者是 “语法糖”)。
综上,我们可以得到 ![[My page]] 应该等效于 。
当然,我们也可以使用其他形式的语法。比如,Roam Research 的嵌入语法为
{{embed: ((NODE_ID))}}
。我们曾经想过使用((Page name))
这样的形式来表示嵌入,但后来我们认为还是 ![[Page Name]] 的形式能更好地与其他语法保持一致,便于记忆,同时也能减少符号的占用,让其他符号能够表示其他含义。
你可以通过以下语法调整嵌入到笔记中的图片的大小:
Markdown 风格的嵌入,使用  这样的语法。
一般的嵌入,使用 ![[image.png|100x100]] 这样的语法。
如果要根据图像的宽高比例进行缩放,请省略高度,如 ![[image.png|100]]。
Obsidian URI 可以让你在其他应用或 Obsidian 的其他库中打开当前库的某篇笔记。
比如,你可以通过以下方式跳转到某个库中的某篇笔记(请注意 URI 的编码):
1 | [打开某篇笔记](obsidian://open?path=D:%2Fpath%2Fto%2Ffile.md) |
如果 url 中含有空格的话,空格需要转义为 %20
,如:
1 | [Export options](Pasted%20image) |
当然,你也可以用 <>
将空格包含起来,如:
1 | [Slides Demo](<Slides Demo>) |
示例:Slides Demo
Comments 注释
所谓注释,指的是会在编辑模式中显示,但不会在预览模式中显示的内容。使用 %%
可以将内容变为注释。以下为语法:
1 | 这里是行内注释:%%预览模式下你将看不到这句话%% |
以下为示例:
这里是行内注释:%% 预览模式下你将看不到这句话 %%
这里是跨行注释:
%%
所谓跨行
就是可以有很多行
%%
标注 Callouts
参考:Callouts
GFM 也存在类似的语法:Style guide - GitHub Docs
Microsoft 也有类似的语法,详看后文。
支持以下类型:
- note
- abstract, summary, tldr
- info
- todo
- tip, hint, important
- success, check, done
- question, help, faq
- warning, caution, attention
- failure, fail, missing
- danger, error
- bug
- example
- quote, cite
[!Any]
当类型不在列表中时。
[!note]
Lorem ipsum dolor sit amet
[!abstract]
Lorem ipsum dolor sit amet
[!summary]
[!tldr]
[!info]
Lorem ipsum dolor sit amet
[!todo]
Lorem ipsum dolor sit amet
[!tip]
Lorem ipsum dolor sit amet
[!hint]
[!important]
[!success]
Lorem ipsum dolor sit amet
[!check]
[!done]
[!question]
Lorem ipsum dolor sit amet
[!help]
[!faq]
[!warning]
Lorem ipsum dolor sit amet
[!caution]
[!attention]
[!failure]
Lorem ipsum dolor sit amet
[!fail]
[!missing]
[!danger]
Lorem ipsum dolor sit amet
[!error]
[!bug]
Lorem ipsum dolor sit amet
[!example]
Lorem ipsum dolor sit amet
[!quote]
Lorem ipsum dolor sit amet
[!cite]
折叠:
[!question]- 折叠尝试(无折叠内容)
[!cite]- 折叠尝试(默认关)
折叠内容
[!success]- 折叠尝试(默认开)
折叠内容
在不打断笔记流的情况下使用标注附加内容。
[!info]
默认标题
Here’s a callout block.
It supports Markdown, Wikilinks and embeds!无序列表:
- 项目 1
有序列表:
- 项目 a
[!tip] 自定义标题
公式渲染:
$$
r+v-e=2
$$行内代码:
Class<?> class = MyClass.class;
图片:
[!error] 标题内公式 $a^2 + b^2 = c^2$,标题内代码
Hello world!
[!cite] 标题内图片:
图片后文字
[!question] Can callouts be nested?
[!todo] Yes!, they can.
[!example]+ You can even use multiple layers of nesting.
[!cite]- 折叠尝试
折叠内容
其他
图表
Obsidian 通过 Mermaid 及其所提供的 编译器 来为用户提供图表的绘制功能。
Microsoft Learn
参考:Markdown reference for Microsoft Learn - Contributor guide | Microsoft Learn
Microsoft Learn 还支持自定义 Markdown 扩展。
例如:警报(备注、提示、重要提示、提醒、警告)
[!NOTE]
Information the user should notice even if skimming.
[!TIP]
Optional information to help a user be more successful.
[!IMPORTANT]
Essential information required for user success.
[!CAUTION]
Negative potential consequences of an action.
[!WARNING]
Dangerous certain consequences of an action.
其他语法详见文档:Microsoft Learn 的 Markdown 参考 - Contributor guide | Microsoft Learn
【提示:与 OFM 的 Callouts 语法一致,具体详看 OFM】
附录
HTML 支持情况
1 | <video src="xxx.mp4" /> # 这个放在Hexo会使后文无法显示,故此处以代码块包围 |
可以使用普通的 <img>
标签指定图片的高度与宽度:
一般标签
不在 Markdown 涵盖范围之内的标签,都可以直接在文档里面用 HTML 撰写。
使用 Ctrl+Alt+A 快速打开 QQ 截屏工具,这里使用了 <kbd>
标签
这是下标 这是上标 换行标签
换行了
标签:
强调的内容 (好像和斜体差不多) [^ 斜体] 语气更强 (粗体?)[^ 加粗] 代码 scanf()
变量 引用
字体、颜色和大小
粗体文本 斜体文本 大号字体 小号字体 等宽文本 下划线
黑体 微软雅黑 华文彩云 华文行楷 时尚中黑 (我猜你电脑里装有什么字体就能用什么字体)
黄色高亮
#00ffff gray 色 #0099ff size = 5 黑体
折叠段落
Title
content设置锚点
这里给出两种方法实现锚点
跳转到这里 2
表格
我占了三行 | 第一列 | 第二列 | 第三列 |
---|---|---|---|
第一列 | 第二列 | 第三列 | |
第一列 | 第二列 | 第三列 |
段首缩进
使用特殊占位符,不同占位符所占空白是不一样大的(请在源码模式下查看):
或者 表示一个半角的空格
或者 表示一个全角的空格
或者 两个全角的空格(用的比较多)
或者 不断行的空白格
特殊符号
© ™ & < > £ ¥ € ® ± § X² Y³ ¾ « » 37.2ºC
Mermaid 图示例
流程图
横向流程图
1 | graph LR |
竖向流程图
1 | graph TD |
UML 标准时序图
1 | %% 时序图例子,-> 直线,-->虚线,->>实线箭头 |
甘特图
1 | %% 语法示例 |
sequence 图示例
【提示】Obsidian 不支持。
UML 时序图
1 | 对象A->对象B: 对象B你好吗?(请求) |
UML 标准时序图复杂
1 | Title: 标题:复杂使用 |
flow 图
流程图代码分两块,上面一块是创建你的流程(创建元素),然后隔一行,创建流程的走向 (连接元素)。
- 创建流程(元素):tag=>type: content:>url
- tag 是流程图中的标签,在第二段连接元素时会用到。名称可以任意,一般为流程的英文缩写和数字的组合。
- type 用来确定标签的类型,
=>
后面表示类型。由于标签的名称可以任意指定,所以要依赖 type 来确定标签的类型(start、end、operation、subroutine、condition、inputoutput) - content 是流程图文本框中的描述内容,
:
后面表示内容,中英文均可。特别注意,冒号与文本之间一定要有个空格 - url 是一个连接,与框框中的文本相绑定,
:>
后面就是对应的 url 链接,点击文本时可以通过链接跳转到 url 指定页面
- 指向流程 (连接元素):标识(类别)-> 下一个标识
- 使用 -> 来连接两个元素
- 对于 condition 类型,有 yes 和 no 两个分支,如示例中的 cond (yes) 和 cond (no)
- 每个元素可以制定分支走向,默认向下,也可以用 right 指向右边,如示例中 cond2 (yes,right)。
【提示】Obsidian 不支持。
标准流程图(横向)
1 | st=>start: 开始框 |
标准流程图
1 | st=>start: 开始框 |
PlantUML 文本绘图
1 | @startuml |