2.1.0 • Published 4 years ago

gfm-loader v2.1.0

Weekly downloads
3
License
MIT
Repository
github
Last release
4 years ago

gfm-loader

Webpack loader to apply gfm styles to html transformed via markdown-loader

License MIT Npm Downloads

Webpack loader to wrap markdown which has been been transformed to html in a <body> tag and apply gfm (github flavored markdown) styles.

Install

Npm Version

$ npm install gfm-loader

Usage

In webpack config (read loaders from bottom to top):

{
  rules: [
    {
      test: /\.md$/,
      use : [
        `file-loader?name=<output-path>`, // Save to given path
        `gfm-loader`, // Wrap html in body, apply gfm styles
        "extract-loader", // Extract html
        "html-loader", // Load html
        "markdown-loader", // Transfrom md -> html
      ]
    }
  ]
}

Example

See: examples/webpack.config.js

Rendered example (with border=true):

Rendered example

API

gfm-loader?gfm=&style=&js=&border=true

gfm:

href for the gfm stylesheet.

`gfm-loader?gfm=build/css/gfm.css`

style:

href for an additional stylsheet. To customize gfm styles.

`gfm-loader?gfm=build/css/gfm.css&style=build/css/bundle.css`

js: src for an additional script file for customization.

`gfm-loader?js=build/js/bundle.js`

border:

Include styles for a Github style border around the body. See example image above.

`gfm-loader?gfm=build/css/gfm.css&style=build/css/bundle.css&border=true`

Changelog

2.0.0:

  • Rename parameter href to gfm
  • Add parameters style and border

Related

  • setup-webpack - Simplifies eg. markdown transpilation; the module this loader was built for

License

MIT © Jonathan Neidel