知识体系 / 博客 规范
2021-07-15 76
我的知识体系摸索了3次,现在慢慢统一规范了
术语定义:
默认:以下术语均使用在 baklib 博客 里面,默认不加博客前缀了
【文章】:baklib 里面的文章
【博客】:作者角度,指的是在后台管理众多文章的界面
【标签】:baklib 文章都有可选的标签
【转义】:文章(特别是教程类)编辑过程中,有不少需要代码需要避开 markdown 的渲染而直接输出代码,因此就有转义符号/
【】:
文章写作规范
- 博客整理相关
- 文章标题
- 标签
- 文章相关
-
段头
- 段头空格
-
段中
- 转义写
- 列表
-
段尾
博客整理相关
文章标题
- 顶级栏目:【大分类】(比如小玩具)
- 二级栏目
- 【大分类】(比如小玩具)栏目归档
- 二级栏目
(特殊的是)
- 沉淀
- 归档文件夹
- (标签)
- 归档文件夹
例子:
- 文章名:2020zxdx-1沟通方案选择
- 命名格式:[年份]+[标签名字拼音缩写]+“-”+“数字”+[简介]
标签:2020招新短信
- 标签名字:[年份]+[标签名字缩写]

列表
- 有固定数目的用 有序列表
- 不确定的用 无序列表,
- 顺序参照 - + * * *
- 每行隔多两个空格
- 第四级列表以后都用 *
例子:
- 这是一级列表
- 这是二级列表
- 这是三级列表
- 这是四级列表
- 这是五级列表
- 这是四级列表
- 这是三级列表
- 这是二级列表
- 这是一级列表
+ 这是二级列表
* 这是三级列表
* 这是四级列表
标题格式

就拿严格解释的现代刑法举例:结构是“编”、章、节、条、款、项
因此得出格式规范:
| (现实)书本里头 | (网站)文章目录 | (网站)markdown 格式 |
|---|---|---|
| 编 | 一级标题 | # 第五编 1500年以前 |
| 章 | 二级标题 | ## 第21章 |
| 节 | 三级标题 | ### 经济发展 |
| 自定义标题1 | 四级标题 | #### 900~1300: 增长 |
| 自定义标题2 | 五级标题 | ##### 【标题内容】 |
| 自定义标题3 | 六级标题 | ###### 【标题内容】 |
段头
空格 (段头的空格使用两个单空格,而不是两个空格)
插入两个空格 (non-breaking space)
这是一段文字的开头
效果:
这是一段文字的开头
段中
转义字符 \
-
不加转义字符,最后一个括号就包含不进去
[[show]](Thislinkhave())
效果:[show])
-
加了转义字符:
[[show]](This_link_have())
效果:[show]
段尾
知识体系构建:https://pdai.tech/md/about/me/about-arch.html