研究了一个markdown做多级编号

2019-07-29  本文已影响0人  waterchinap

markdown虽然说比较简单,但如果用来弄一个结构比较复杂的长文的话,如果不分级别,就很难看了。

markdown不能象word那样自动组织多级编号的,所以只能事先规划好结构。

我的体会是如果是有多级的文章。先是用#号来区分出几级标题来,一般在三级,最多四级,再多就乱了。标题可以采取

第一部:财务管理

第一章:财务报表分析

第一节:财务指标

一:流动比率

再往下就考虑用段落来组织了,特别复杂的,可以再加一级如:

(一)流动比率定义

后续就是段落了。

普通的段落就是这个样子。一般如果到(一)这个级别,能用简单的几段文件说清楚的,就用普通的段落。如果还说不清楚,再用#来分级就太乱了。可考虑这样的思路。
下一级用有序列表,再下一级用无序列表。
比如:

  1. 定义的说明1

  2. 定义的说明2
    这中间加普通段落是不会影响后续的连续编号的。
    如果段落后,空一行,也不影响后面连续编号,但整个列表会变得很松散。就象这样。

  3. 定义的说明3
    来看看再下一级会如何?

    • 在简书中试出来是缩进3个空白就会成为下一级列表。
    • 再度试一试。
  4. 没有问题,连续列表继续进行。
    如果实在是还想缩进的话,应该是在每一个级别后面至少再多加两个空格,但超过3个会不会引起什么情况?。试一下吧:

    • 这是第二级列级
      • 这是第三级列表:这是加2到5个空格的效果。
    • 这是第二级列表
      - 这是从第二级开始算,加6个空格的效果,和上一个相比,好象是间距更小了点,但级别是不是有变就不知道了。
  5. 再看看,连续编号还是没有断。
    加代码块会影响连续编号的。

this is some code
  1. 这时候连续编号就断了。

  2. 如果不想被代码块打断怎么办?

    这是缩进了三个空格的代码块,这```号和代码文字都要缩进三个空格才行。
    
  3. 现在看就不会打断了。
    但有的时候想打断怎么办?

  4. 比如象现在,加了一个普通段是不会打断的,加二级列表,二级代码块也是不会打断的。

  5. 加两个回车也不能打断。这时候,你需要在最后一个列表项后面加两个空行,并且第二个空行写上一个普通段落,或者加两个空格都能断开了。

我想重新开始列表

  1. 这样就断开列表了。

引用块也能够断开列表。和代码块的道理一个样,如果不想让引用块断开列表,在>号前面加上三个空格,那后面的编号就会继续。
在简书中,回车好象是有效的。但其他地方好象要在结尾加两个空格,回车才有效。

  1. 后面就从1开始编号了。

按照这样的思路组织文章,总共有:部、章、节、一、(一)、1、及无序列表七个级别,应该能够组织好文章了。

如果有希望按照:

1.
1.1.
1.1.1.
1.1.1.1.

这样的方式来组织文章,有人做了一个插件来实现。看各人喜好了。
https://github.com/legendmohe/markdown_index

上一篇下一篇

猜你喜欢

热点阅读