Markdownlint



-->

Markdownlint is a static analysis tool for Node.js with a library of rules to enforce standards and consistency for Markdown files. It was inspired by - and heavily influenced by - Mark Harrison's markdownlint for Ruby. The initial rules, rule documentation, and test cases came directly from that project. Language: MarkdownChecks: 41Categories: StyleVersion: 0.5.0 markdownlint is a tool designed to check markdown files and flag style issues.To enable MarkdownLint analysis, add the following to your.codeclimate.yml configuration file:More information about the CLI is available in the README here: ht.

This post was written by Adam Kinney, Senior Software Engineer on the docs.microsoft.com team.

Today, we are delighted to announce the release of the Docs Authoring Pack for Visual Studio Code, making it easier than ever to contribute to docs.microsoft.com. This first release of the pack includes three extensions:

  • Docs Markdown - provides Markdown authoring assistance including formatting text, inserting lists and tables, inserting links to other content, and adding images and other assets. Unlike other Markdown editors, Docs Markdown supports custom Markdown extensions for docs.microsoft.com, such as alerts and code snippets.
  • DocFX - provides a limited docs.microsoft.com-specific Markdown preview to help see what your Markdown file will look like when published.
  • markdownlint - a popular Markdown linter by David Anson to help ensure your Markdown follows best practices.

How it Works

First, you will need to install it from the Visual Studio Marketplace. Once you navigate to the extension page, simply click on Install and follow the messages on the screen:

Once done, you should reload Visual Studio Code, open a Markdown file, and start writing! Use the Alt+M key combination to access the Docs Markdown Extension command palette, allowing you to quickly format the text (e.g. make it bold or italic), insert standard Markdown entities, such as a numbered list or a table, as well as insert docs-specific markup for notes, important information and tips:

You can also quickly insert code from other files via a DocFX-compatible Markdown extension, and preview the page you are working on directly in the editor:

Contribute

The extension is open source, and we welcome any contributions to it!

Most contributions require you to agree to a Contributor License Agreement (CLA) affirming that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com.

Gfm

When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all Microsoft-owned repos using our CLA.

Feedback

Markdownlint

Have thoughts on how we can make the extension better? Simply open a new issue!

Markdown Extension Vs Code

And don't forget to follow our Twitter account for the latest updates.

Dreaming of making the world better for developers? Join our team!

This addin for Cake allows you to lint Markdown files using markdownlint.

Markdownlint Gitlab

For projects that support PackageReference, copy this XML node into the project file to reference the package.
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r directive can be used in F# Interactive, C# scripting and .NET Interactive. Copy this into the interactive tool or source code of the script to reference the package.
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Release Notes

Dependencies

Markdownlint Ignore File

This package has no dependencies.

Vscode Linter

Used By

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Pipeline-components / Markdownlint · GitLab

Version History

Markdownlint Pre-commit

VersionDownloadsLast updated
1.0.0 1,698 2/12/2021
0.3.0 6,258 8/13/2019
0.2.0 2,147 6/23/2018
0.1.0 568 5/27/2018
0.1.0-beta0001 480 4/4/2018