Switch for disabling fragments

[mil-ad]

Is there a way to disable data-marpit-fragment fragments when exporting to HTML? They're super useful when presenting and I'd like to keep them in my markdown files but when sharing presentation files it'd be useful to have the option to disable them.

[yhatt]

In Marp CLI, you can inject a plugin for disabling the Marpit internal fragment plugin to Marp Core engine.

marp --engine marp-engine-with-disable-fragment.mjs your-markdown.md

// marp-engine-with-disable-fragment.mjs
export default ({ marp }) => marp.use((md) => md.core.ruler.disable('marpit_fragment'))

[mil-ad]

this works but I already have a custom engine with a bunch of tweaks so can't really use this as a flag to toggle the behaviour

[yhatt]

Try to chain the extracted plugin, and control via process.env whether enable or disable fragments.

// disableMarpitFragmentsPlugin.mjs
export default (md) => {
  if (process.env.DISABLE_FRAGMENTS) md.core.ruler.disable('marpit_fragment')
}

// your-engine.mjs
import yourExistingPlugin from '......'
import yetAnotherPlugin from '......'
import disableMarpitFragmentsPlugin from './disableMarpitFragmentsPlugin.mjs'

export default ({ marp }) =>
  marp.use(yourExistingPlugin)
      .use(yetAnotherPlugin)
      .use(disableMarpitsFragmentPlugin)

And you can control fragments in the command line like this:

DISABLE_FRAGMENTS=true marp --engine your-engine.mjs markdown.md

First off, let me roll out this as a plugin to watch if the Marp community finds this concept worthwhile.
https://github.com/marp-team/.github/blob/master/CONTRIBUTING.md#before-adding-new-feature