feat: add Marked instance

[UziTech]

Description

Add import { Marked } from 'marked' to get an instance of marked that will not change global options when options are changed or extensions are added.

import { Marked } from 'marked';
const marked = new Marked(options); // or new marked.Instance(options)
marked.use(extension);

marked.parse(markdown);

This initial parameters are passed to use so you can add options or extensions.

const marked = new Marked(
  options,
  extension1,
  extension2
)

// same as

const marked = new Marked();
marked.use(
  options,
  extension1,
  extension2
);

import { marked } from 'marked' still works the way it always has by updating global options.

• Fixes Setting options interferes with other "require"-calls to marked. #907

Contributor

• Test(s) exist to ensure functionality and minimize regression (if no tests added, list tests covering this PR); or,
• no tests required for this PR.
• If submitting new feature, it has been documented in the appropriate places.

Committer

In most cases, this should be a different person than the contributor.

• CI is green (no forced merge required).
• Squash and Merge PR following conventional commit guidelines.

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
marked-website	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Jun 8, 2023 8:14pm

[styfle]

Is this supposed to be an array? The tests make it seems like its an object, not array.

[UziTech]

The constructor can take any number of options objects just like the use function. The square brackets mean it is optional. I know it is a weird way of writing that but that is how we indicate optional arguments in other parts of the docs.

[UziTech]

I updated it to be more informative

[calculuschild]

I approve after @styfle 's points get addressed.

[styfle]

Great, thanks! 🎉

Perhaps we can move toward a future were we deprecate and remove the old marked that mutates global state in favor of this new class instance 👍

[vorant94]

when is it expected to get 5.1.0 version of @types/marked to use instance-based marked in typescript?