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

[kingpo]

Markdowm 写静态文章博客，现在用 obisidian 编辑器。有几个问题一直很困扰。

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

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

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

问下各位有什么最佳实践没有，类似论文的标准格式那样。

[qwq11]

1. 标题字体太小你可以改 css 自己调。至于说的不够错落有致，我觉得因为是字太少，格式太繁多的原因(因为我之前也喜欢这样写)，可以参考下其他人的文章，你会发现很多大段大段的段落中间跟一两个 ul 或者 ol ，排版和文字都看起来很流畅
2. op 还是看下语法文档吧，行尾两个空格表示不分段换行，两行之间空一行表示分段

[shinyzhu]

没有标准。

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

要公开的话，用一个静态网站框架就可以，看这里： https://jamstack.org/generators/
一般会用 frontmatter 来记录元数据，然后图片管理也挺烦。

[kingpo]

2. 这个我知道，但总觉得多打了两个空格，就不够干净。有点强迫症

[kingpo]

@qwq11 #1 2. 这个我知道，但总觉得多打了两个空格，就不够干净。有点强迫症

[aydd2004]

所以，我觉得所谓的 Markdown 文档应该不适宜绝大部分人。

你可以写的挺好看，但这其中你得折腾多久心里没点数么？

[GabrielleBellamy]

为了减少格式上的折腾，我之前写了几个软件，自荐一下
https://github.com/Ryan-the-hito/Avocado [去年写的，今年快要重构升级了]
https://github.com/Ryan-the-hito/Strawberry [学术向的，还没写简介呢]

[GabrielleBellamy]

@GabrielleBellamy

[wszzh]

我看过的写文档指南：

阮一峰写的： https://github.com/ruanyf/document-style-guide 。

以及 https://open.leancloud.cn/copywriting-style-guide/

[CEBBCAT]

我认为还是渲染得不行（主题），另外也要从内容上入手。比如之前的报纸文章，不用太多格式就能说很多道理

[dfkjgklfdjg]

1. 标题其实很随意，只要保证一个页面只有一个 h1 标签就是了，其他的 h2 、h3 等等就是看你的 markdown 主题或者 HTML 样式是怎么设置的了。缩进之类的也是同理。
2. 其实你可以连敲两个回车，也可以空格空格+回车。
- 两个回车等于另起一个 p 标签
- 空格空格回车等于一个<br>
3. 一般最佳实践就是看书写习惯，因为排版的关系我习惯在单词左右用空格隔开。全角还是半角标点就看你前后文是否是中文，如果是中文自然是使用全角的，当然如果因为兼容 Coding 很多人默认中文也是半角的，那也无所谓。并不影响阅读。

使用 markdown 的初衷就是可以简单快速排版，可以让自己更专注于内容。而且很多 md 编辑器都是支持实时预览的，尽量让自己的编辑器和博客保持同一个主题就好了。

[whileFalse]

先写，再改排版。
另外，普通博客谨慎长篇大论

[foufoufm]

排版实际上没那么重要，自己在写的时候不一定会发，要发就一定要符合读者的预期，所以二次更改是避免不了的。现实中不存在你直接写了就能发的文章，这是实打实的经验。

[kingpo]

@dfkjgklfdjg #10 比如标题，你们还会在前面加序号吗？

[dfkjgklfdjg]

@kingpo #13 ，一般来说不会，但是比如说一些有关联性的内容会手动增加序号。
比如说在说一些安装步骤的时候，会以 一、二、三 或者 1 、2 、3 这样起标题（ h2 或者 h3 类型）。
大部分的时候并不会有什么关联，所以都是直接写标题就好了。其实就是看当时的心情。