V2EX = way to explore

V2EX 是一个关于分享和探索的地方

现在注册

已注册用户请登录

这是一个专门讨论 idea 的地方。

每个人的时间，资源是有限的，有的时候你或许能够想到很多 idea，但是由于现实的限制，却并不是所有的 idea 都能够成为现实。

那这个时候，不妨可以把那些 idea 分享出来，启发别人。

这是一个创建于 564 天前的主题，其中的信息可能已经有所发展或是发生改变。

排版思考

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

# 一级标题

## 二级标题

### 三级标题

序号、列表

折叠功能 ▶

文档字数多了从视觉上总是让人产生不耐烦的表情（娱乐类除外，学习与阅读本身就是阶梯式的难度）
这时候加入 ▶ 功能后，把大段文字折叠起来，让人能“一眼望到底”，逻辑脉络清洗，产生继续阅读的动力
每一次点开或收起一个 ▶ ，总会觉得完成了一段 goal ，cool 吧
这在 notion 、flowus 、语雀等软件里也支持，叫做“折叠”或者“折叠标题”

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

它的语法如下：

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

(输入内容)

</p>
</details>

图示效果（来源网络）

Less is more

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

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

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

你们认为呢？

折叠

Markdown

标题

排版

25 条回复 • 2023-04-25 17:43:34 +08:00

7gugu

2023-04-21 15:54:12 +08:00

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

matzoh

2023-04-21 16:13:58 +08:00

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

freepoint

2023-04-21 16:14:20 +08:00

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

Pastsong

2023-04-21 16:54:52 +08:00

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

freepoint

2023-04-21 17:00:35 +08:00

@Pastsong 谢谢道友提醒🤔

codehz

2023-04-21 17:16:59 +08:00 via iPhone

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

0o0O0o0O0o

2023-04-21 17:18:09 +08:00 via iPhone

偶尔在 issues 里贴 log 会用

7gugu

2023-04-21 17:26:37 +08:00

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

freepoint

2023-04-21 17:36:33 +08:00

@codehz god damn

freepoint

2023-04-21 17:37:40 +08:00

@7gugu 我是菜逼😂

yunyuyuan

2023-04-21 17:46:32 +08:00

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

2023-04-21 18:07:44 +08:00

这不就是 logseq 吗

freepoint

2023-04-21 18:28:38 +08:00

@itskingname 没用过😂

itskingname

2023-04-21 18:59:54 +08:00

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

starrys

2023-04-21 19:21:16 +08:00 via Android

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

alne

2023-04-21 20:13:28 +08:00

@itskingname 太卡了

723X

2023-04-21 21:38:45 +08:00

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

asmoker

2023-04-22 00:42:53 +08:00 via Android

看各家的实现吧

ETiV

2023-04-22 04:09:45 +08:00 via iPhone

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

jorneyr

2023-04-22 08:06:48 +08:00

Obsidian 的 Markdown 支持这个功能。

hahastudio

2023-04-22 08:59:48 +08:00

有一点可能不太好定义，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