mm-mark

ESM Only

Convert Markdown to HTML

Mmmark : Convert Md to Html with Showdown.Js.

Main dependencies bundled license information.

1. Showdown.js

Showdown.js is a powerful JavaScript library used for converting Markdown into HTML. It's a key dependency in our project, providing the core functionality of our Markdown to HTML conversion.

• Version: 2.1.0
• Release Date: 21-04-2022
• Showdown.js GitHub
• License: MIT

2. JS-YAML

JS-YAML is a JavaScript implementation of YAML, a human-friendly data serialization standard. In our project, it's used for parsing YAML front matter in Markdown files.

• Version: 4.1.0
• JS-YAML GitHub
• License: MIT

3. Other dependencies

• Prism.Js for code block highlight.
• Mathjax for math support.
• tsup for typescript compile and bundle.

Install from npm

npm i mm-mark

yarn add mm-mark

pnpm i mm-mark

Install from jsr.io

deno

deno add @ptm/mm-mark

npm

npx jsr add @ptm/mm-mark

yarn

yarn dlx jsr add @ptm/mm-mark

pnpm

pnpm dlx jsr add @ptm/mm-mark

bun

bunx jsr add @ptm/mm-mark

Import

import * as mod from "@ptm/mm-mark";

Markdown to HTML.

import { mdConverter } from "mm-mark";
const mdcontent = `
---
title: hello world
date: 2024-07-07
tags:
    - foo
    - bar
---


## Hello

`;
const converter = mdConverter(/*{Showdown Options} */);
// set flavor for this converter
converter.setFlavor("github");
const html = converter.makeHtml(mdcontent);
console.log(html); // <h2 id="hello">Hello</h2>

Frontmatter

import { frontmatter } from "mm-mark/frontmatter";
type MyType = {
  type: string;
  title: string;
};

const mdcontent = `
    ---
    title: hello world
    date: 2024-07-07
    tags:
        - foo
        - bar
    ---


    ## Hello

    `;

const foo = frontmatter<MyType>(mdcontent);
console.log(foo.data); // { title: 'hello world',  date: 2024-07-07T00:00:00.000Z, tags: [ 'foo', 'bar' ] }
console.log(foo.content); // ## Hello

Extensions

Available Extensions

1. icons

2. copyCode

3. customClass

4. twitter

5. youtube

You can use any showdown extensions.

import { mdConverter } from "mm-mark";
import { icons } from "mm-mark/extensions";
const converter = mdConverter(
  /*{Showdown Extensions} */ { extensions: [icons] }
);
const html = converter.makeHtml("@fa-home");