Enabling superscript and/or subscript doesn't work.

🐛 Bug Report

Enabling superscript and/or subscript doesn’t work.

Have you read the Contributing Guidelines on issues?

Yes

To Reproduce

(Write your steps here:)

1. Install and initialize docusaurus 1.14 (npx docusaurus-init)
2. Enable sup and sub in remarkable (siteconfig.js) as described in docs: https://docusaurus.io/docs/en/site-config.

markdownPlugins: [
  function foo(md) {
    md.inline.ruler.enable(['sub', 'sup']);
  },
],

1. Add page with ¹ tag or ^1^ (doc2 in demo)

Expected behavior

The 1 character or “st” should be rendered to html superscript

Actual Behavior

The 1 character and “st” are rendered as regular text in html.

Your Environment

• Docusaurus version used: 1.14
• Environment name and version (e.g. Chrome 78.0.3904.108, Node.js 10.17.0): Chromium 83.0.4103.106, Node.js 12.16.2
• Operating system and version (desktop or mobile): Windows 10 1909

Reproducible Demo

https://github.com/jodibooksHQ/docusaurus-bug-2979

[slorber]

the latest version of docusaurus throws if you attempt to supply remarkPlugins in the config

This is plugin option config, not global site config (also why it’s not in the global config validation logic)

Added documentation for Katex today: https://docusaurus.io/docs/next/markdown-features/math-equations

If you want to enable extra md features on v2, you can pass remark plugins as documented (not in the migration guide)

Going to close as we likely won’t do anything for v1

[joeplaa]

@naddeoa I ran into the same issue with the documentation about plugins being (still) a bit vague. Hopefully they will be improved soon, now that v2 is out of alpha. I don’t have a straight answer for you as I’m also “just” a Docusaurus user, but maybe this will help you along.

• The current document about how to use plugins: https://docusaurus.io/docs/next/markdown-features/plugins.
• This is indeed how I’ve done it in v2, see example below on how I implemented/use KaTeX.
• By the way, the superscript and subscript worked out of the box for me in v2.

1. import / require plugins at the top of docusaurus.config.js:

const remarkMath = require('remark-math');
const rehypeKatex = require('rehype-katex');

1. now also in docusaurus.config.js add to presets (not plugins !?):

presets: [
        [
            `@docusaurus/preset-classic`,
            {
                blog: {},
                docs: {
                    showLastUpdateAuthor: true,
                    showLastUpdateTime: true,
                    path: `docs`,
                    remarkPlugins: [remarkMath],
                    rehypePlugins: [rehypeKatex],
                    sidebarPath: require.resolve('./sidebars.json')
                },
                sitemap: {
                    changefreq: 'weekly',
                    priority: 0.5,
                    trailingSlash: false
                },
                theme: {
                    customCss: [require.resolve(`./src/css/custom.css`)]
                }
            }
        ]
    ],