无需索引
基础语法
标题: #, ##, ###, ####, #####, ######
,分别表示一级标题、二级标题、三级标题……
居中标题:<center>居中渲染</center>
(hansome主题不适用)
加粗: **word**
斜体: *word*
斜体且加粗:***word***
删除符:~~word~~
行内代码:`word`
分隔线:三个或者三个以上的 - 或者 * 都可以
换行:两个空格后回车
列表: 以+/-号开始的为无序号列表,以数字开始为序号列表,下级列表之前为两个空格
- item
1. 次列表
2. 次列表
- item
+ item
链接:<http://www.baidu.com>
或者 [百度首页](http://www.baidu.com)
图片: 
拓展语法
注释
<!--more--> (Bytecats的列表页显示到该标记处)
代码块
markdown代码块:
```
```
html代码块:
```html
```
typecho 的html代码块格式为:
!!!
html代码
!!!
引用
>, >>, >>>
tasklist
- [x] 文档说明
- [ ] 需求分析
效果如下:
- [x] 文档说明
- [ ] 需求分析
表格
markdown表格:
表头|表头|表头
---|:--:|---:
内容|内容|内容
内容|内容|内容
效果如下:
表头 | 表头 | 表头 |
---|---|---|
内容 | 内容 | 内容 |
内容 | 内容 | 内容 |
第二行分割表头和内容。- 可以一个或多个。
文字默认居左,两边加:表示文字居中,右边加:表示文字居右。
注:原生的语法两边都要用 | 包起来,此处省略。
通过 line1 <br> line2
实现单元格内容换行。
html表格:
姓氏 | |
张 | 王 |
锚点
每一个标题都是一个锚点,和HTML的锚点(#)类似,比如:[回到顶部](#readme)
不过要注意,标题中的英文字母都被转化为小写字母了。
以前GitHub对中文支持的不好,所以中文标题不能正确识别为锚点,但是现在已经没问题了!
diff语法
版本控制的系统中都少不了diff的功能,即展示一个文件内容的增加与删除。其语法与代码高亮类似,只是在三个反引号后面写diff,并且其内容中,以 +开头表示新增(绿色),-开头表示删除(红色)。
脚注
为名词提供注释,注释将显示在文章末尾。
语法:
待注释文字[^脚注 id]
[^脚注 id]:注释内容
示例:
Hello May[^may]
[^may]:即:每年的公历五月份
效果:
Hello May1
脚注的注意事项:
脚注 id 必须唯一。
无论脚注 id 如何起名,显示时一律标为数字,并且按出现顺序排列。
画图
graph TD;
A{Status}-->|inactive|B(CLEAR);
A-->|active|C[Hidden];
B-->D((END));
C-->D;
即: A --> B,显示的内容可用 {},[],(),(())括起来,如果没有则直接显示A或者B。源和目的之间可以使用 || 写条件。
注意:写完后,要切换一个源码模式,图形才会出来。
Title:connection
note left of client: desc
note over midlleware: desc
note right of server: desc
client->client: to self
client->midlleware: bone to bone
client-->server: not bone
midlleware->>server:bone and not bone
midlleware-->>client:not bone and not bone
一个短 - 和一个 > 表示实线和实箭头,两个 - 和两个 > 表示虚线和空箭头,两者可以任意组合。
本站特有
高亮提示文本
有三种样式,默认的样式如上,可以通过"size" 属性来修改,另外两种效果如下:
!>(空格)文字 表示黄色警告框
i>(空格)文字 表示蓝色信息框
@>(空格)文字 表示银色引用框
x>(空格)文字 表示红色错误框
√>(空格)文字 表示绿色成功框
拼音
拼音
外链卡片
- title:必填,外链的名称/标题
- url:必填,外链的地址(请填写绝对地址,就是浏览器地址栏什么样的就填什么样的)
- intro:(可选)外链网站的简介/介绍
- cover:(选填)外链网站的介绍图片地址
文章卡片
点击编辑器的调用文章的按钮可以调用其他文章并显示。
cid:必填,是文章的唯一编号
cover:可选项,调用文章显示的封面,如果不填则默认显示随机缩略图。
size:可选项,可填写值large 、small,默认为large。small表示只显示文章标题,不显示其他额外信息。
链接卡片
按钮
handsome支持以下类型的按钮:
矩形文字按钮
椭圆形文字按钮
矩形图标文字按钮
- type:选填,不填默认为矩形按钮。可选值:round,椭圆形按钮
- color:选填,不填默认为success(绿色),可选值:light:白色,info:蓝色,dark:深色,success:绿色,black:黑色,warning:黄色,primary:紫色,danger:红色
- icon:选填,不填默认为文字按钮,可用按钮见图标列表https://auth.ihewro.com/user/docs/#/preference/icons
url:选填,填写点击的链接。举例:如果你的链接是http://www.baidu.com,请手动将/前面加一个反斜杆,即http://www.baidu.com
举例:
计划表
阅读10本书 :
每天锻炼30分钟 :
计划表中包含了三种类型的任务:
- check类型,该类型任务只有两种状态,完成和未完成
- progress,该类型任务可以显示任务执行的进度,需要手动填写进度
start、end,该类型任务设置一个起始时间和终止时间,进度会根据当前时间自动更新进度
- 时间格式:必须是正确的时间格式,比如2021-01-02 12:00 ,也可以只写日期2021-01-02
时间线
-
梦开始的地方
-
2020-1-20武汉封城,疫情让一起变得慌乱起来
-
2020-3-20开始远程办公,慢慢有序起来
-
生活变得好起来了
-
2020-10-1国庆节去哈尔滨旅行,和老同学见面
-
新的一年开始
timeline 属性列表:
- type:可选项,默认为small, 可选值:small 小巧款式的时间线; large 大款式的时间线。
- random:可选项,默认为true,可选值为true、false。true表示时间线每一条会使用随机的色彩。
- start/end:对于 large 样式的时间线,提供时间线开始和结束的一个文字自定义。
item 属性列表:
- date :可选项,默认不显示时间,可填上一个日期文字,实际上可以填写任何类型文字(不要太长)
- color:可选项,设置当前时间线条的颜色,可选值:"light", "info", "dark", "success", "black", "warning", "primary", "danger"
部分内容回复可见
在文章使用使用
hide
标签包裹住你想要隐藏的内容,游客必须先回复后才能查看隐藏内容。
部分内容登录可见
在文章中使用
为什么增加这样的功能呢?因为有时候一篇文章并不想完全的加密,部分内容由于隐私问题需要加密。该部分内容仅登录用户(如果是个人博客就是仅博主)可见。
收缩框
其中status为false 表示默认不显示文字内容,为true表示默认显示内容。
标签卡
每个 tab 都必须包括 name 属性,只能有一个 tab 添加 active 属性,表示默认显示该 tab 的内容。
此外 tab 支持更多 css 的属性,比如颜色,字体粗细等:
[tab name="标签页 2" color:"#000" font-weight="bold"]高级内容文本示例[/tab]
标签tag
默认颜色文字
紫色文字
蓝色文字
黄色文字
红色文字
绿色文字
黑色文字
- 即:每年的公历五月份 ↩