Markdown ▶ 折叠功能的思考

[freepoint]

排版思考

话说一般人写 markdown 也就是这样吧

# 一级标题

## 二级标题

### 三级标题

序号、列表

折叠功能 ▶

• 文档字数多了从视觉上总是让人产生不耐烦的表情（娱乐类除外，学习与阅读本身就是阶梯式的难度）

• 这时候加入 ▶ 功能后，把大段文字折叠起来，让人能“一眼望到底”，逻辑脉络清洗，产生继续阅读的动力

• 每一次点开或收起一个 ▶ ，总会觉得完成了一段 goal ，cool 吧

• 这在 notion 、flowus 、语雀等软件里也支持，叫做“折叠”或者“折叠标题”

但是 Markdown 软件我试了下很多不带这功能，最近在 github 网站我发现 issue 里面可以由 / 调出来，

它的语法如下：

<details><summary>输入折叠标题</summary>
<p>

(输入内容)

</p>
</details> 

图示效果（来源网络）

Less is more

简洁美观的排版总是让人心旷神怡，有阅读的快感，自己写作也好，别人阅读也罢，正如能量公式的推导展开异常复杂，而公式却极度简洁： E=Mc²

其实写这个帖子重点不在于单纯分享这个功能，而在于抛砖引玉，发现写作过程中简洁实用的功能。

我的感受也只是目前我的水平或者审美在这里，我相信网上也有分享各种排版功能的，重点是分享出简单常用的东西出来，毕竟人的进化和工具的迭代都类似，某种程度都遵循“用进废退”的原则，简单易用才能常用常新。

你们认为呢？

[7gugu]

看起来不错，但是混杂了 html 标签下去感觉又没有那么纯粹了

[matzoh]

我不太喜欢折叠这个操作，更喜欢看大纲，侧边栏的大纲常年都是开启状态

[freepoint]

@7gugu #1 是哎，Markdown 没有这样纯粹的折叠语法，尴尬。

[Pastsong]

Markdown 本质是 HTML 的语法糖，html 标签都支持的，具体支持什么样要看对应平台实现，没有标准的

[freepoint]

@Pastsong 谢谢道友提醒🤔

[codehz]

其实混合 html 倒也不是啥大问题，问题是不同 md 实现对“html tag 内的文本”处理不一样，有时候写个 tag ，里面的格式化标记就变成原文输出了，有时候又可以。。。
不写 html 的时候，起码有最基础的一致性

[0o0O0o0O0o]

偶尔在 issues 里贴 log 会用

[7gugu]

@freepoint 其实想变纯粹也有得搞，可以设定一种自定义的语法规则用来代替 html 标签，这样子就可以更加纯粹而不掺杂标签

[freepoint]

@codehz god damn

[freepoint]

@7gugu 我是菜逼😂

[yunyuyuan]

https://github.github.com/gfm/#:~:text=Start%20condition%3A%20line%20begins%20the%20string%20%3C%20or%20%3C/%20followed%20by%20one%20of%20the%20strings%20(case%2Dinsensitive)
可以参考一下 gfm ，挺多 markdown 编辑器都支持 gfm ，其实一般也用不到那么多

[itskingname]

这不就是 logseq 吗

[freepoint]

@itskingname 没用过😂

[itskingname]

@freepoint 你用用看，完美满足你的需求。

[starrys]

这个应该由客户端来实现就可以了吧，可以看看 VSCode 的 Markdown 插件有没有这样的功能

[alne]

@itskingname 太卡了

[723X]

@itskingname 一样，太卡了，并且左侧菜单白屏，只好报告 bug 后卸载。

[asmoker]

看各家的实现吧

[ETiV]

Notion 的> 其实是把标准 markdown 里的 blockquote 的标记用途给改了

[jorneyr]

Obsidian 的 Markdown 支持这个功能。

[hahastudio]

有一点可能不太好定义，markdown 的“语法”基本都是符号，那么什么样的符号可以呢？
更像渲染内容的话，比如这样的符号用 |> 的话，可能是这样的：

|> title: Summary Goes Here
|> ...this is hidden, collapsable content...

我没用过 reStructuredtext ，只是看到好像用扩展可以实现 https://github.com/dgarcia360/sphinx-collapse

另外，以前论坛的 bbcode 有这功能，[collapse][/collapse] https://www.rprepository.com/help/bbcode#75

[wonderfulcxm]

我记得 GitHub 的 issue 也支持折叠语法

[qqqyh]

Obsidian 支持折叠标题和缩进

[hyperzlib]

@7gugu 是的，比如 WikiCode 的扩展语法

```{{折叠|折叠的内容}}```

这样的

[aydd2004]

好几年前选择 notion 就是看中了折叠功能，特别对笔记类的东西，条理特别清晰。

[houchangxiaowang]

obsidian 的 callout 命令 可以折叠
> [!NOTE]- Title
> Contents