编写高通用多功能Markdown

待办列表

你可以在 - [ ] content 中的中括号内填入不同的内容，来显示不同的效果:

- [ ] space
- [x] x
- [!] !
- [-] -
- [+] +
- [>] >
- [?] ?

其他测试，无效

- [~] ~
- [@] @
- [#] #
- [$] $
- [%] %
- [&] &
- [*] *
- [(] (
- [)] )
- [=] =
- [<] <
- [/] /
- [:] :
- [|] |

杂项，未整理

取自 25-08-28 在 VuePress Theme Hope 我个人的发言

1. markdown标准最理想的，就是text进，output一个html，这是最好的。这样纯markdown-it就能完成。
2. 其次，就是使用markdown-it，再import点css
3. 再往后，就是需要更多环境才能工作的东西。如组件、需要vuepress/vitepress接口的一些插件等

不过，gfm也不纯是text->html，gfm alert就带样式，说起来其实还好

github.com/MJRT/markdown-it-task 支持

如果是我用任务列表想要表示更多状态，我会用🟡✅❌ emoji，
或者 - [ ] (任务状态) 任务内容，
我不用这个的

那我继续说下我对这个语法的看法，其向下兼容会有些问题（如图），而且dom+css没办法很好地通过点击/菜单方式方式手写（可视化得加js）

既然要手写，- [ ] (Doing) 在做啦别催啦 会不会更通用？

• 缺点
  • 在于没有复用目前已经存在的做法（反正我不知道有），没有复用OFM或我上面发的那个markdown-it-task的语法
• 优点
  • 向下兼容性，gfm，以及能支持github自己的task统计（已完成/未完成）
  • 在于没有任何插件额外支持的情况下，可读性非常优秀
  • 可扩展性强，如：- [ ] (任务状态) 任务内容 中，任务状态不仅可以是状态 (doing)，能支持中文 (进行中，暂搁置，放弃)，能支持预估//deadline日期（yyyy-mm-dd），能支持进行进度 (16/19)，等等……

只是提出一种语法设计，可以补充优缺点、可以与原设计比较

需要一定强制规则然后被语法解析并渲染的，就是语法

gfm的alert同理，> [!warning]

和非语法的 “提示” 的本质区别在于：不允许按个人意愿 “微调语法”，不然识别不出来

讲个趣事，我以前也有用过一些任务列表（如trello）是支持写日期（开始时间和结束时间，也能只写结束时间）

但我那时就不用他提供的，而是用这种方式手写日期的。

原因1：他那个不支持md语法
原因2：我用md task 语法来代替来支持一些子任务的情况，如：

- [ ] 大任务
    - [x] 小任务一
    - [ ] 小任务二

原因3：他那个日期的编辑会有比较明显的编辑记录，用md伪装task痕迹不重。所以我经常可以偷偷地修改死线日期（hhhhh）

我观点是只要不强绑就好，现在也没有支持这种语法的东西啊，我不还一样写

- [ ] (Doing) content

反正别人看了明白是什么意思就行。所谓支持也不是把他改得面目全非，无非就是一点可有可无的样式美化。就像 gfm alert 一样，不支持的环境（如typora）我也照写 [!warning] 不误

适用于纸质的技巧、及符号指导 —— 子弹笔记

然后如果真要弄这种，其实纸质笔记也是可以这样写的，甚至有专门的技巧和符号指导，叫子弹笔记

take from: https://meet.eslite.com/tw/sc/product/202107210001

他这个比较重要的一个特性在于对符号的覆写

如 - 变 +，> 或 < 变 x，空心变实心，用删除线划掉，等等

ob 群聊2

我觉得我的小括号标注法很强，除非要用脚本整理成表格之类的。
然后每个任务有各种参与人员、开始和结束时间、类型 (bug/feat) 等（像kanban那样）
我直接： - [是否完成] (这里什么都能标，时间，人员等) 任务项内容

全部状态要集中在任务图标里，会太过局限了。不过有部分东西我觉得有些参考价值 —— 纸质笔记的符号手写变动

• 这个就是像你可以用 x，填进 [ ] 那样
• > 和 < 可以变 x
• - 可以变 +
• 然后 O 可以边 \O (假设这两重叠)
• 等等

想使用标题的样式，但不想让标题在大纲中显示

见下章

隐标题/非根部标题

有种叫隐标题的技巧，就是你想使用标题的样式，但不想让标题在大纲中显示，有什么方法呢。

• 方法一是你手动在大纲中进行折叠。
  • 适合临时折叠
• 方法二是一些插件有只显示到N级标题的功能，如 “Obsidian 插件 Quiet Outline”，如自建博客平台时往往有这样的设置
  • 适合全局隐藏5/6级标题这种低级别标题
• 方法三是使用 “隐标题”，即不处于文档根部的标题。使用一个 > 或 - 在标题前面引一下。这样就即有标题的样式，又不在大纲中显示。而且常规标题和隐标题的样式还可以分别设置。
  • 适合各个文章想隐藏的标题都不同的情况，文章A隐藏三级，文章B隐藏四级，文章C不隐藏，这样
• 方法四是不使用标题，如使用带 title 而不带 content 的 obsidian 空 callout
  • 但带 tittle 的 callout 语法通用性不强，不推荐
• 方法五是使用带样式的 HTML 标签
  • 不建议使用过多 HTML 标签，特别是带 style 属性的 HTML 标签。安全性起见，公共平台会限制 Markdown HTML 的 style 属性。具体详见 Md实用标签2

# 1

## 2

### 3

#### 4

##### 5

###### 6

- # mm

sdfgdfsg

- ## dsf

sdfgdfsg

- ### sdf

sdfgdfsg

- #### sdf

sdfgdfsg

- ##### sdf

sdfgdfsg

- ###### sdfsd

sdfgdfsg

> # mm

sdfgdfsg

> ## dsf

sdfgdfsg

> ### sdf

sdfgdfsg

> #### sdf

sdfgdfsg

> ##### sdf

sdfgdfsg

> ###### sdfsd

sdfgdfsg

再说兼容性：反正我在别的平台这样用没问题。

图一左为Typora，图一右为Github，图二为我的Vuepress博客，图三为Obsidian。

Typora 与 Obsidian 的 css 可以参考我的自用样式仓库: https://github.com/LincZero/LincZero-Help-Oneself

(上图可以看到，隐标题不参与到大纲中)