[v2] unable to use theme-classic without remark-admonitions
See original GitHub issueš Bug Report
Due to https://github.com/facebook/docusaurus/blob/master/packages/docusaurus-theme-classic/src/index.js#L56, you are unable to to use the @docusaurus/theme-classic theme without installing the remark-admonitions module. This shouldnāt be a hard requirement.
Have you read the Contributing Guidelines on issues?
Yep
To Reproduce
- Create a V2 project with the following config
'use strict';
module.exports = {
title: 'gulp.js',
favicon: 'img/favicon.png',
url: 'https://gulpjs.com/',
baseUrl: '/',
tagline: 'The streaming build system',
// Used by the deployment
organizationName: 'gulpjs',
projectName: 'gulpjs.github.io',
// The theme
themeConfig: {},
themes: ['@docusaurus/theme-classic'],
plugins: [
['@docusaurus/plugin-content-docs', {
path: '../converted-docs'
}]
]
};
- Try to run the project
- See this error message

Expected behavior
The theme should be usable without external dependencies unless I opt-in.
Actual Behavior
Doesnāt compile and is unusable without installing the remark-admonitions module.
Your Environment
- Docusaurus version used:
^2.0.0-alpha.50 - Environment name and version (e.g. Chrome 78.0.3904.108, Node.js 10.17.0): 10.15.1
- Operating system and version (desktop or mobile): desktop
Reproducible Demo
None currently because Iām trying to upgrade the gulp websiteā¦
Issue Analytics
- State:
- Created 3 years ago
- Reactions:1
- Comments:8 (4 by maintainers)
Top Results From Across the Web
@lebalz/remark-admonitions - npm
A remark plugin for admonitions designed with Docusaurus v2 in mind. remark-admonitions is now included out-of-the-box with @docusaurus/preset-Ā ...
Read more >chrisvxd-docusaurus-preset-classic - npm package - Snyk
Unable to verify the project's public source code repository. Advisor Ā· JavaScript packages Ā· chrisvxd-docusaurus-preset-classicĀ ...
Read more >2.0.0-beta.19 - Docusaurus
#7304 fix(theme-classic): remove breadcrumb items without href from microdata (@Josh-Cena) Ā· #7179 fix(theme-classic): do not add microdata itemĀ ...
Read more >Docusaurus/CHANGELOG and Docusaurus Releases (Page 6)
... docusaurus-plugin-content-docs , docusaurus-preset-classic , docusaurus-theme-classic. #2642 fix(v2): use remark-admonitions separately in each pluginĀ ...
Read more >Docusaurus 2 Changelog - Breword ę攣éå
#2477 chore(v2): upgrade remark-admonitions for a11y fixes (@lex111) ... fix(v2): do not force terminate building if client bundle failed inĀ ...
Read more >
Top Related Medium Post
No results found
Top Related StackOverflow Question
No results found
Troubleshoot Live Code
Lightrun enables developers to add logs, metrics and snapshots to live code - no restarts or redeploys required.
Start Free
Top Related Reddit Thread
No results found
Top Related Hackernoon Post
No results found
Top Related Tweet
No results found
Top Related Dev.to Post
No results found
Top Related Hashnode Post
No results found

@lex111 is there a reason that
remark-admonitionsisnāt just providing that lifecycle hook for itself?@phated we really love the feedback from our users, thank you for that. We welcome any feedback, because we are still in the alpha stage.
I tend to include admonitions in every plugin (both for docs and blogs), instead of doing this in a preset. I think it was a predictable behavior.
BTW consider adding your project to our showcase at https://v2.docusaurus.io/showcase š