Skip to content
This repository has been archived by the owner on May 4, 2022. It is now read-only.

pcgilday/remark-lint

 
 

Repository files navigation

remark-lint

Build Status Coverage Status

remark-lint is a markdown code style linter. Another linter? Yes. Ensuring the markdown you (and contributors) write is of great quality will provide better rendering in all the different markdown parsers, and makes sure less refactoring is needed afterwards. What is quality? That’s up to you, but the defaults are sensible 👌.

remark-lint has lots of tests. Supports Node, io.js, and the browser. 100% coverage. 50+ rules. It’s built on remark, a powerful markdown processor powered by plugins (such as this one).

Table of Contents

Installation

npm:

npm install remark-lint

remark-lint is also available for duo, and as an AMD, CommonJS, and globals module, uncompressed and compressed.

Command line

Example of how remark-lint looks on screen

Use remark-lint together with remark:

npm install --global remark remark-lint

Let’s say example.md looks as follows:

* Hello

[World][]

Then, to run remark-lint on example.md:

remark example.md -u remark-lint
#
# Yields:
#
# example.md
#         1:3  warning  Incorrect list-item indent: add 2 spaces  list-item-indent
#    3:1-3:10  warning  Found reference to undefined definition   no-undefined-references
#
# ⚠ 2 warnings

See doc/rules.md for what those warnings are (and how to turn them off).

Programmatic

doc/api.md describes how to use remark-lint’s programatic interface in JavaScript.

Rules

doc/rules.md describes all available rules, what they check for, examples of markdown they warn for, and how to fix their warnings.

Configuring remark-lint

remark-lint is just a remark plug-in. Meaning, you can opt to configure using configuration files. Read more about these files (.remarkrc or package.json) in remark’s docs.

An example .remarkrc file could look as follows:

{
  "plugins": {
    "lint": {
        "no-multiple-toplevel-headings": false,
        "maximum-line-length": 79,
        "emphasis-marker": "_",
        "strong-marker": "*"
    }
  },
  "settings": {
    "commonmark": true
  }
}

Where the object at plugins.lint is a map of ruleIds and their values. The object at settings determines how remark parses (and compiles) markdown code. Read more about the latter on remark’s readme.

In addition, you can also provide configuration comments to turn a rule on or off inside a file. Note that you cannot change what a setting, such as maximum-line-length, checks for, as you’re either enabling or disabling warnings). Read more about configuration comments in remark-message-controls documentation.

The following file will warn twice for the duplicate headings:

# Hello

## Hello

### Hello

The following file will warn once (the second heading is ignored, but the third is re-enabled):

# Hello

<!--lint disable no-duplicate-headings-->

## Hello

<!--lint enable no-duplicate-headings-->

### Hello

Using remark to fix your markdown

One of remark’s cool parts is that it compiles to very clean, and highly cross-vendor supported markdown. It’ll ensure list items use a single bullet, emphasis and strong use a standard marker, and that your table fences are aligned.

remark should be able to fix most of your styling issues automatically, and I strongly suggest checking out how it can make your life easier 👍

Editor Integrations

Currently, remark-lint is integrated with Atom through linter-markdown.

I’m very interested in more integrations. Let me know if I can help.

List of External Rules

Related

License

MIT © Titus Wormer

About

Markdown code style linter

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 100.0%