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

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

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

Markdown ▶ 折叠功能的思考

  •  1
     
  •   freepoint · 343 天前 · 3749 次点击
    这是一个创建于 343 天前的主题,其中的信息可能已经有所发展或是发生改变。

    排版思考

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

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

    折叠功能 ▶

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

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

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

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

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

    它的语法如下:

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

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

    Less is more

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

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

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

    你们认为呢?

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

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

    这样的
    aydd2004
        25
    aydd2004  
       338 天前
    好几年前选择 notion 就是看中了折叠功能,特别对笔记类的东西,条理特别清晰。
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   我们的愿景   ·   实用小工具   ·   5418 人在线   最高记录 6543   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 29ms · UTC 08:47 · PVG 16:47 · LAX 01:47 · JFK 04:47
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.