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

[mil-ad]

Sorry for bringing this back to life @yhatt but doesn't it make more sense for this to be a feature of bespoke and marp-cli? I'm thinking of having a go at adding it

[yhatt]

It should first gather consensus within the Marp community. Adding a feature means increasing complexity and maintenance burden for us, so Marp team wants to implement only ideas that have proven the value.
https://github.com/marp-team/.github/blob/master/CONTRIBUTING.md#before-adding-new-feature

(In particular, we consider the bespoke template to be just a reference implementation of the HTML powered by @marp-team/marp-core, so it should keep minimum)

[uglycoyote]

Not a member of the Marp community, but I think it definitely makes sense to have a way of turning this off just with a comment/directive within the markdown.

I'm a long-time user of https://remarkjs.com and just kicking the tires on Marp. This auto-fragment behaviour is one of the first things I ran into which I consider an "annoyance" that I immediately went looking for a way to disable. IMHO the page https://marpit.marp.app/fragmented-list needs a "how to turn it off" section, or it should really be an optional feature that you can opt-in to if you want it.

I realize that docs say that the the bullet lists using a hyphen will avoid the fragmentation behaviour, but I always use asterisks for my bullet points and I don't really want to have to change that habit or reformat existing markdown in order to disable the fragmentation feature.

Needing to install a plugin to use a "custom engine" to disable this is ludicrous.

[yhatt]

Probably your opinion is related to marp-team/marpit#357. At this time, this opinion has not received as much attention as other issues, so we are not taking any action. If it gains more attention, implementation may proceed.