Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Remove Numbering for Top-Level Headers When Adding Markdown Section Numbers #1490

Open
iCasture opened this issue Dec 28, 2024 · 2 comments
Open

Comments

@iCasture
Copy link

When using Markdown to write documents, the top-level header is typically reserved for the document title and should only appear once in most cases. It should not be numbered when section numbering is added.

For example, given the following document:

# Document Title

## Section One

### Subsection One

### Subsection Two

## Section Two

### Subsection One

## Section Three

After adding section numbers, the result would currently look like this:

# 1. Document Title

## 1.1. Section One

### 1.1.1. Subsection One

### 1.1.2. Subsection Two

## 1.2. Section Two

### 1.2.1. Subsection One

## 1.3. Section Three

When rendered, it appears as:

Could you consider adding an option to skip numbering the top-level header? This way, the numbered output would look like:

# Document Title

## 1. Section One

### 1.1. Subsection One

### 1.2. Subsection Two

## 2. Section Two

### 2.1. Subsection One

## 3. Section Three

Additionally, could you also consider implementing the functionality requested in #1380?

@icytree
Copy link

icytree commented Jan 14, 2025

I was also looking for this feature, here's an easy workarround that might quite the job (it really did for me)!

@iCasture
Copy link
Author

@icytree

Thank you for providing a solution to resolve this issue. But I still hope the developers can offer an option to ignore it.

Additionally, I found another plugin: Markdown TOC & Chapter Number, which ignores numbering for level 1 headings by default.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants