Add @it-service-npm/remark-heading-adjustment to list of plugins by sergey-s-betke · Pull Request #1479 · remarkjs/remark · GitHub
Skip to content

Add @it-service-npm/remark-heading-adjustment to list of plugins - #1479

Open
sergey-s-betke wants to merge 5 commits into
remarkjs:mainfrom
IT-Service-NPM:main
Open

sergey-s-betke wants to merge 5 commits into
remarkjs:mainfrom
IT-Service-NPM:main

Conversation

@sergey-s-betke

@sergey-s-betke sergey-s-betke commented Feb 24, 2026 •

Copy link
Copy Markdown
Contributor

Initial checklist

  • I read the support docs
  • I read the contributing guide
  • I agree to follow the code of conduct
  • I searched issues and discussions and couldn’t find anything or linked relevant results below
  • I made sure the docs are up to date
  • I included tests (or that’s not needed)

Description of changes

Updated plugins list.

Added a new plugins:

@it-service-npm/remark-gfm-admonition extends Remark’s functionality,
enabling it to read GitHub admonitions from Markdown
and to write them back to Markdown files.

Also published:

@it-service-npm/remark-heading-adjustment Remark plugin helps to adjust headings depth in markdown file.

When processor.data().topHeadingDepth is specified, this plugin adjusts all headings so that the depth of the top heading aligns with the given value.

This plugin can be used for dynamically change headings depth. Example: https://github.com/IT-Service-NPM/remark-include/blob/649937ef3eb87bc1b0f3bbe8e4a9a47509aba5fc/src/index.ts#L214C1-L226C1

The plugin also exports a preset called remarkAdjustTopHeadingToH1. This preset includes the remarkHeadingsAdjustment plugin with settings {topHeadingDepth: 1}.

These are meant for use in .remarkrc files and help normalize the depth of the top-level heading.

@github-actions github-actions Bot added the 👋 phase/new Post is being triaged automatically label Feb 24, 2026
@github-actions

This comment has been minimized.

@github-actions github-actions Bot added 🤞 phase/open Post is being triaged manually and removed 👋 phase/new Post is being triaged automatically labels Feb 24, 2026
@sergey-s-betke sergey-s-betke changed the title Add @it-service-npm/remark-heading-adjustment to list of plugins Add @it-service-npm/remark-gfm-admonition to list of plugins Mar 2, 2026
@codecov

codecov Bot commented Mar 2, 2026 •

Copy link
Copy Markdown

@remcohaszing

Copy link
Copy Markdown
Member

I’m ok with adding @it-service-npm/remark-heading-adjustment. However, I oppose adding @it-service-npm/remark-gfm-admonition. GFM doesn’t have admonitions. GitHub’s rendering pipeline transforms certain HTML output into admonitions.

> [!NOTE]
> This is an admonition.

> \[!TIP]
> This is an admonition.

> [!TIP]
> This is a regular blockquote.

[!TIP]: https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#alerts

Yields:

Note

This is an admonition.

Tip

This is an admonition.

!TIP
This is a regular blockquote.

@sergey-s-betke

Copy link
Copy Markdown
Contributor Author

I’m ok with adding @it-service-npm/remark-heading-adjustment.

Thank You. I'll change pull request.

However, I oppose adding @it-service-npm/remark-gfm-admonition. GFM doesn’t have admonitions. GitHub’s rendering pipeline transforms certain HTML output into admonitions.

Ok. I'll update my package for Your example. Thank You!

@sergey-s-betke

Copy link
Copy Markdown
Contributor Author

@sergey-s-betke sergey-s-betke changed the title Add @it-service-npm/remark-gfm-admonition to list of plugins Add @it-service-npm/remark-heading-adjustment to list of plugins Apr 4, 2026

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

🤞 phase/open Post is being triaged manually

Development

Successfully merging this pull request may close these issues.

2 participants