Markdown 折叠功能的思考 - V2EX
V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
这是一个专门讨论 idea 的地方。

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

那这个时候,不妨可以把那些 idea 分享出来,启发别人。
freepoint
V2EX    奇思妙想

Markdown 折叠功能的思考

  •  1
     
  •   freepoint 2023-04-21 15:41:14 +08:00 4591 次点击
    这是一个创建于 908 天前的主题,其中的信息可能已经有所发展或是发生改变。

    排版思考

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

    # 一级标题 ## 二级标题 ### 三级标题 序号、列表 

    折叠功能

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

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

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

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

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

    它的语法如下:

    <details><summary>输入折叠标题</summary> <p> (输入内容) </p> </details> 

    图示效果(来源网络) 折叠

    Less is more

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

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

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

    你们认为呢?

    26 条回复    2024-12-28 20:35:15 +08:00
    7gugu
        1
    7gugu  
       2023-04-21 15:54:12 +08:00
    看起来不错,但是混杂了 html 标签下去感觉又没有那么纯粹了
    matzoh
        2
    matzoh  
       2023-04-21 16:13:58 +08:00
    我不太喜欢折叠这个操作,更喜欢看大纲,侧边栏的大纲常年都是开启状态
    freepoint
        3
    freepoint  
    OP
       2023-04-21 16:14:20 +08:00
    @7gugu #1 是哎,Markdown 没有这样纯粹的折叠语法,尴尬。
    Pastsong
        4
    Pastsong  
       2023-04-21 16:54:52 +08:00   1
    Markdown 本质是 HTML 的语法糖,html 标签都支持的,具体支持什么样要看对应平台实现,没有标准的
    freepoint
        5
    freepoint  
    OP
       2023-04-21 17:00:35 +08:00
    @Pastsong 谢谢道友提醒
    codehz
        6
    codehz  
       2023-04-21 17:16:59 +08:00 via iPhone
    其实混合 html 倒也不是啥大问题,问题是不同 md 实现对“html tag 内的文本”处理不一样,有时候写个 tag ,里面的格式化标记就变成原文输出了,有时候又可以。。。
    不写 html 的时候,起码有最基础的一致性
    0o0O0o0O0o
        7
    0o0O0o0O0o  
       2023-04-21 17:18:09 +08:00 via iPhone
    偶尔在 issues 里贴 log 会用
    7gugu
        8
    7gugu  
       2023-04-21 17:26:37 +08:00
    @freepoint 其实想变纯粹也有得搞,可以设定一种自定义的语法规则用来代替 html 标签,这样子就可以更加纯粹而不掺杂标签
    freepoint
        9
    freepoint  
    OP
       2023-04-21 17:36:33 +08:00
    @codehz god damn
    freepoint
        10
    freepoint  
    OP
       2023-04-21 17:37:40 +08:00
    @7gugu 我是菜逼
    yunyuyuan
        11
    yunyuyuan  
       2023-04-21 17:46:32 +08:00   2
    itskingname
        12
    itskingname  
       2023-04-21 18:07:44 +08:00
    这不就是 logseq 吗
    freepoint
        13
    freepoint  
    OP
       2023-04-21 18:28:38 +08:00
    @itskingname 没用过
    itskingname
        14
    itskingname  
       2023-04-21 18:59:54 +08:00   1
    @freepoint 你用用看,完美满足你的需求。
    starrys
        15
    starrys  
       2023-04-21 19:21:16 +08:00 via Android
    这个应该由客户端来实现就可以了吧,可以看看 VSCode 的 Markdown 插件有没有这样的功能
    alne
        16
    alne  
       2023-04-21 20:13:28 +08:00
    @itskingname 太卡了
    723X
        17
    723X  
       2023-04-21 21:38:45 +08:00
    @itskingname 一样,太卡了,并且左侧菜单白屏,只好报告 bug 后卸载。
    asmoker
        18
    asmoker  
       2023-04-22 00:42:53 +08:00 via Android
    看各家的实现吧
    ETiV
        19
    ETiV  
       2023-04-22 04:09:45 +08:00 via iPhone   1
    Notion 的> 其实是把标准 markdown 里的 blockquote 的标记用途给改了
    jorneyr
        20
    jorneyr  
       2023-04-22 08:06:48 +08:00
    Obsidian 的 Markdown 支持这个功能。
    hahastudio
        21
    hahastudio  
       2023-04-22 08:59:48 +08:00   1
    有一点可能不太好定义,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
        22
    wonderfulcxm  
       2023-04-22 09:24:32 +08:00 via iPhone
    我记得 GitHub 的 issue 也支持折叠语法
    qqqyh
        23
    qqqyh  
       2023-04-22 23:51:00 +08:00 via Android   1
    Obsidian 支持折叠标题和缩进
    hyperzlib
        24
    hyperzlib  
       2023-04-25 11:06:49 +08:00   1
    @7gugu 是的,比如 WikiCode 的扩展语法

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

    这样的
    aydd2004
        25
    aydd2004  
       2023-04-25 17:43:34 +08:00
    好几年前选择 notion 就是看中了折叠功能,特别对笔记类的东西,条理特别清晰。
    houchangxiaowang
        26
    houchangxiaowang  
       291 天前
    obsidian 的 callout 命令 可以折叠
    > [!NOTE]- Title
    > Contents
    关于     帮助文档     自助推广系统     博客     API     FAQ     Solana     1215 人在线   最高记录 6679       Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 20ms UTC 23:36 PVG 07:36 LAX 16:36 JFK 19:36
    Do have faith in what you're doing.
    ubao msn snddm index pchome yahoo rakuten mypaper meadowduck bidyahoo youbao zxmzxm asda bnvcg cvbfg dfscv mmhjk xxddc yybgb zznbn ccubao uaitu acv GXCV ET GDG YH FG BCVB FJFH CBRE CBC GDG ET54 WRWR RWER WREW WRWER RWER SDG EW SF DSFSF fbbs ubao fhd dfg ewr dg df ewwr ewwr et ruyut utut dfg fgd gdfgt etg dfgt dfgd ert4 gd fgg wr 235 wer3 we vsdf sdf gdf ert xcv sdf rwer hfd dfg cvb rwf afb dfh jgh bmn lgh rty gfds cxv xcv xcs vdas fdf fgd cv sdf tert sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf shasha9178 shasha9178 shasha9178 shasha9178 shasha9178 liflif2 liflif2 liflif2 liflif2 liflif2 liblib3 liblib3 liblib3 liblib3 liblib3 zhazha444 zhazha444 zhazha444 zhazha444 zhazha444 dende5 dende denden denden2 denden21 fenfen9 fenf619 fen619 fenfe9 fe619 sdf sdf sdf sdf sdf zhazh90 zhazh0 zhaa50 zha90 zh590 zho zhoz zhozh zhozho zhozho2 lislis lls95 lili95 lils5 liss9 sdf0ty987 sdft876 sdft9876 sdf09876 sd0t9876 sdf0ty98 sdf0976 sdf0ty986 sdf0ty96 sdf0t76 sdf0876 df0ty98 sf0t876 sd0ty76 sdy76 sdf76 sdf0t76 sdf0ty9 sdf0ty98 sdf0ty987 sdf0ty98 sdf6676 sdf876 sd876 sd876 sdf6 sdf6 sdf9876 sdf0t sdf06 sdf0ty9776 sdf0ty9776 sdf0ty76 sdf8876 sdf0t sd6 sdf06 s688876 sd688 sdf86