V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
V2EX 提问指南
kingpo
V2EX  ›  问与答

Markdown 文章有什么好的模板或最佳实践经验,这几个痛点各位是如何接解决的

  •  
  •   kingpo · 2023-07-18 10:00:26 +08:00 · 1971 次点击
    这是一个创建于 480 天前的主题,其中的信息可能已经有所发展或是发生改变。
    Markdowm 写静态文章博客,现在用 obisidian 编辑器。有几个问题一直很困扰。

    1. 标题多少级合适,一般大于三级,又太细,少了又不够分点,再用 无序和有序,排版又不够错落有致,各位又是如何嵌套,标题、有序、无序、加粗等,缩进是怎么多少空格符,还是 tab 。

    2. 换行符在 Markdown 中是不换行的,空格才是换行,或者加多个空格,有时编排后,在博客一预览,很多段落或要换行的总是不对,需要二次调整。

    之前看到 github 有一个实践经验,比如中英文之间要有空格,中文要用全角符,英文半角符,等,但还是不够详细。

    问下各位有什么最佳实践没有,类似论文的标准格式那样。
    14 条回复    2023-07-21 11:04:22 +08:00
    qwq11
        1
    qwq11  
       2023-07-18 10:11:36 +08:00 via Android   ❤️ 1
    1. 标题字体太小你可以改 css 自己调。至于说的不够错落有致,我觉得因为是字太少,格式太繁多的原因(因为我之前也喜欢这样写),可以参考下其他人的文章,你会发现很多大段大段的段落中间跟一两个 ul 或者 ol ,排版和文字都看起来很流畅
    2. op 还是看下语法文档吧,行尾两个空格表示不分段换行,两行之间空一行表示分段
    shinyzhu
        2
    shinyzhu  
       2023-07-18 10:13:44 +08:00 via iPhone
    没有标准。

    Obsidian 本身还只是一个私有管理工具,想怎么写怎么写,可以用上标签和引用链接,但其他工具不支持。

    要公开的话,用一个静态网站框架就可以,看这里: https://jamstack.org/generators/
    一般会用 frontmatter 来记录元数据,然后图片管理也挺烦。
    kingpo
        3
    kingpo  
    OP
       2023-07-18 10:14:59 +08:00
    2. 这个我知道,但总觉得多打了两个空格,就不够干净。有点强迫症
    kingpo
        4
    kingpo  
    OP
       2023-07-18 10:15:15 +08:00
    @qwq11 #1 2. 这个我知道,但总觉得多打了两个空格,就不够干净。有点强迫症
    aydd2004
        5
    aydd2004  
       2023-07-18 10:17:31 +08:00
    所以,我觉得所谓的 Markdown 文档应该不适宜绝大部分人。

    你可以写的挺好看,但这其中你得折腾多久心里没点数么?
    GabrielleBellamy
        6
    GabrielleBellamy  
       2023-07-18 10:53:50 +08:00   ❤️ 1
    为了减少格式上的折腾,我之前写了几个软件,自荐一下
    https://github.com/Ryan-the-hito/Avocado [去年写的,今年快要重构升级了]
    https://github.com/Ryan-the-hito/Strawberry [学术向的,还没写简介呢]
    GabrielleBellamy
        7
    GabrielleBellamy  
       2023-07-18 10:54:30 +08:00
    wszzh
        8
    wszzh  
       2023-07-18 11:13:00 +08:00
    CEBBCAT
        9
    CEBBCAT  
       2023-07-18 11:26:30 +08:00
    我认为还是渲染得不行(主题),另外也要从内容上入手。比如之前的报纸文章,不用太多格式就能说很多道理
    dfkjgklfdjg
        10
    dfkjgklfdjg  
       2023-07-18 11:48:27 +08:00
    1. 标题其实很随意,只要保证一个页面只有一个 h1 标签就是了,其他的 h2 、h3 等等就是看你的 markdown 主题或者 HTML 样式是怎么设置的了。缩进之类的也是同理。
    2. 其实你可以连敲两个回车,也可以空格空格+回车。
    - 两个回车等于另起一个 p 标签
    - 空格空格回车等于一个<br>
    3. 一般最佳实践就是看书写习惯,因为排版的关系我习惯在单词左右用空格隔开。全角还是半角标点就看你前后文是否是中文,如果是中文自然是使用全角的,当然如果因为兼容 Coding 很多人默认中文也是半角的,那也无所谓。并不影响阅读。

    使用 markdown 的初衷就是可以简单快速排版,可以让自己更专注于内容。而且很多 md 编辑器都是支持实时预览的,尽量让自己的编辑器和博客保持同一个主题就好了。
    whileFalse
        11
    whileFalse  
       2023-07-18 12:03:00 +08:00 via Android
    先写,再改排版。
    另外,普通博客谨慎长篇大论
    foufoufm
        12
    foufoufm  
       2023-07-18 12:59:32 +08:00
    排版实际上没那么重要,自己在写的时候不一定会发,要发就一定要符合读者的预期,所以二次更改是避免不了的。现实中不存在你直接写了就能发的文章,这是实打实的经验。
    kingpo
        13
    kingpo  
    OP
       2023-07-21 10:53:42 +08:00
    @dfkjgklfdjg #10 比如标题,你们还会在前面加序号吗?
    dfkjgklfdjg
        14
    dfkjgklfdjg  
       2023-07-21 11:04:22 +08:00
    @kingpo #13 ,一般来说不会,但是比如说一些有关联性的内容会手动增加序号。
    比如说在说一些安装步骤的时候,会以 一、二、三 或者 1 、2 、3 这样起标题( h2 或者 h3 类型)。
    大部分的时候并不会有什么关联,所以都是直接写标题就好了。其实就是看当时的心情。
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   1142 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 25ms · UTC 23:45 · PVG 07:45 · LAX 15:45 · JFK 18:45
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.