remark-lint

Linting Markdown Files

This feature allows you to lint Markdown files to ensure they adhere to specified style guidelines. The code sample demonstrates how to use remark-lint to process a simple Markdown string and report any issues.

const remark = require('remark');
const lint = require('remark-lint');

remark()
  .use(lint)
  .process('# Hello world!', function (err, file) {
    console.error(report(err || file));
  });

Custom Rules

remark-lint supports custom rules, allowing you to enforce specific style guidelines. The code sample shows how to use a custom rule (remark-lint-no-emphasis-as-heading) to lint a Markdown string.

const remark = require('remark');
const lint = require('remark-lint');
const noEmphasisAsHeading = require('remark-lint-no-emphasis-as-heading');

remark()
  .use(lint)
  .use(noEmphasisAsHeading)
  .process('# Hello *world*!', function (err, file) {
    console.error(report(err || file));
  });

Configurable Presets

remark-lint provides configurable presets that bundle multiple rules together for convenience. The code sample demonstrates how to use the 'remark-preset-lint-recommended' preset to lint a Markdown string.

const remark = require('remark');
const lint = require('remark-lint');
const presetLintRecommended = require('remark-preset-lint-recommended');

remark()
  .use(lint)
  .use(presetLintRecommended)
  .process('# Hello world!', function (err, file) {
    console.error(report(err || file));
  });