是否可以在降价/折扣中标出编号标题？

我试图生成类似下面的部分/小节标题的 html:

  1. 我的头等话题
    1.1我的第一个副主题
    1.2另一个副主题
    1.2.1子主题
  2. 又一个高层话题

是否有任何 Markdown 的实现能够产生这些类型的编号部分标题？

先谢谢你。

73923 次浏览
小开
最佳答案

Yes, try Pandoc. This works for me:

pandoc --number-sections < test.md > out.html

(Source)

Markdown to produce the numbered outline you mention in the original post looks like this:

# My top-level topic


## My first subtopic


## Another subtopic


### A sub-subtopic


## Another top-level topic

If you want deeper indenting for sub-sections, you might be able to achieve this with inline CSS. For example, placing this at the top of the above Markdown source indents the headers:

<style type="text/css">
h2 { margin-left: 10px; }
h3 { margin-left: 20px; }
</style>

But say you had paragraphs of text under your headings... I don't know how to indent that to the same level as the above header.

Update 2015-10-18: Markdeep has numbered headings (and many other fancy features). Check that out too!

小开

If your markdown tool supports customized theme by CSS, add below snippet into CSS to enable heading number:

body {
counter-reset: h1
}


h1 {
counter-reset: h2
}


h2 {
counter-reset: h3
}


h3 {
counter-reset: h4
}


h1:before {
counter-increment: h1;
content: counter(h1) ". "
}


h2:before {
counter-increment: h2;
content: counter(h1) "." counter(h2) ". "
}


h3:before {
counter-increment: h3;
content: counter(h1) "." counter(h2) "." counter(h3) ". "
}


h4:before {
counter-increment: h4;
content: counter(h1) "." counter(h2) "." counter(h3) "." counter(h4) ". "
}

I use Typora, which supports auto numbering for headings in this approach.

小开

As @adam-monsen points out 'pandoc --number-sections' does the trick. You can also simply add numbersections: true to th YAML-Header to activate numbered headings for your file.

小开

If you want to edit the markdown file itself, and not only the resulting HTML file, try enumerate-markdown with python 3

pip install enumerate-markdown
markdown-enum filename.md 1 filename.md

Example - input

# header 1
text
## header 2
text
# header 3
text

Output

# 1.  header 1
text
## 1.1  header 2
text
# 2.  header 3
text

if you later edit the file and run the script again, then it updates old enumeration.

小开

Markdown is intended to be fast, light, and easy to work with and it fits that bill perfectly. For more complex formatting, good to consider an option other than markdown. Not a cop-out. Often, e.g. with Microsoft languages and tools for example, I would want to do "xyz" and then realize that in that world, you are, by design, steered away from "xyz", to the preferred/supported means of accomplishing your goals.

For a specific example, consider vscode. People ask about toolbar/customization. Vscode isn't toolbar-centric. This is by design. The design intention is to use the command palette Ctrl+Shift+P. Saves time by not having to constantly be customizing your toolbar and it provides fast access to all commands, as opposed to only a subset of commands on the toolbar.


提交答案