kristoferssolo/archived-solorice
1
0
Fork 0
mirror of https://github.com/kristoferssolo/solorice.git synced 2026-03-18 08:09:40 +00:00
Code Issues Packages Projects Releases Wiki Activity

Added vscode settings

Browse Source
This commit is contained in:
Kristofers Solo
2022-04-28 20:54:44 +03:00
parent 245c3ca779
commit 837a479d82
25004 changed files with 2499800 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

43
vscode/extensions/davidanson.vscode-markdownlint-0.47.0/.vsixmanifest Normal file
View File

@@ -0,0 +1,43 @@
<?xml version="1.0" encoding="utf-8"?>
<PackageManifest Version="2.0.0" xmlns="http://schemas.microsoft.com/developer/vsx-schema/2011" xmlns:d="http://schemas.microsoft.com/developer/vsx-schema-design/2011">
<Metadata>
<Identity Language="en-US" Id="vscode-markdownlint" Version="0.47.0" Publisher="DavidAnson" />
<DisplayName>markdownlint</DisplayName>
<Description xml:space="preserve">Markdown linting and style checking for Visual Studio Code</Description>
<Tags>markdown,lint,CommonMark,md,multi-root ready,snippet,json,linters,__web_extension</Tags>
<Categories>Linters,Formatters</Categories>
<GalleryFlags>Public</GalleryFlags>
<Properties>
<Property Id="Microsoft.VisualStudio.Code.Engine" Value="^1.56.0" />
<Property Id="Microsoft.VisualStudio.Code.ExtensionDependencies" Value="" />
<Property Id="Microsoft.VisualStudio.Code.ExtensionPack" Value="" />
<Property Id="Microsoft.VisualStudio.Code.ExtensionKind" Value="workspace,web" />
<Property Id="Microsoft.VisualStudio.Code.LocalizedLanguages" Value="" />
<Property Id="Microsoft.VisualStudio.Services.Links.Source" Value="https://github.com/DavidAnson/vscode-markdownlint.git" />
<Property Id="Microsoft.VisualStudio.Services.Links.Getstarted" Value="https://github.com/DavidAnson/vscode-markdownlint.git" />
<Property Id="Microsoft.VisualStudio.Services.Links.GitHub" Value="https://github.com/DavidAnson/vscode-markdownlint.git" />
<Property Id="Microsoft.VisualStudio.Services.Links.Support" Value="https://github.com/DavidAnson/vscode-markdownlint/issues" />
<Property Id="Microsoft.VisualStudio.Services.Links.Learn" Value="https://github.com/DavidAnson/vscode-markdownlint" />
<Property Id="Microsoft.VisualStudio.Services.GitHubFlavoredMarkdown" Value="true" />
</Properties>
<License>extension/LICENSE.txt</License>
<Icon>extension/images/markdownlint-128.png</Icon>
</Metadata>
<Installation>
<InstallationTarget Id="Microsoft.VisualStudio.Code"/>
</Installation>
<Dependencies/>
<Assets>
<Asset Type="Microsoft.VisualStudio.Code.Manifest" Path="extension/package.json" Addressable="true" />
<Asset Type="Microsoft.VisualStudio.Services.Content.Details" Path="extension/README.md" Addressable="true" />
<Asset Type="Microsoft.VisualStudio.Services.Content.Changelog" Path="extension/CHANGELOG.md" Addressable="true" />
<Asset Type="Microsoft.VisualStudio.Services.Content.License" Path="extension/LICENSE.txt" Addressable="true" />
<Asset Type="Microsoft.VisualStudio.Services.Icons.Default" Path="extension/images/markdownlint-128.png" Addressable="true" />
</Assets>
</PackageManifest>

61
vscode/extensions/davidanson.vscode-markdownlint-0.47.0/CHANGELOG.md Normal file
View File

@@ -0,0 +1,61 @@
# Changes
* 0.47.0 - Miscellaneous improvements
* 0.46.0 - New rules, document formatting, better path handling
* 0.45.0 - Add linting for workspace
* 0.44.0 - Support virtual file systems
* 0.43.0 - Web worker support
* 0.42.0 - Add "focus mode" setting
* 0.41.0 - Workspace trust, virtual workspaces
* 0.40.0 - Switched to `markdownlint-cli2` (see below)
* 0.39.0 - Improved rules, new fix
* 0.38.0 - Improved rules, schemas, new snippet
* 0.37.0 - Improved rules, extends, schema
* 0.36.0 - Add command, improve diagnostics
* 0.35.0 - Improved rules, .markdownlintignore
* 0.34.0 - Improved rules, new fix, JSONC config
* 0.33.0 - Improved rules, new fix, new snippets
* 0.32.0 - Implement fix-on-save
* 0.31.0 - Automatically fix more rule violations
* 0.30.0 - Improved rules, startup performance
* 0.29.0 - Add snippets
* 0.28.0 - Improved rules, capture/restore
* 0.27.0 - Improved rules and custom rule handling
* 0.26.0 - Rule, code action, and performance improvements
* 0.25.0 - Improved startup performance
* 0.24.0 - Improved rules, custom links, math blocks
* 0.23.0 - UI and custom rule improvements
* 0.22.0 - Code action improvements
* 0.21.0 - Custom rule improvements
* 0.20.0 - Enable actions in Problems pane
* 0.19.0 - Improved rules
* 0.18.0 - Add support for YAML config files
* 0.17.0 - Add support for ignoring files
* 0.16.0 - Add support for custom rules
* 0.15.0 - Add option to lint on type or save
* 0.14.0 - Improved rules
* 0.13.0 - New/improved rules
* 0.12.0 - Add support for multi-root workspaces
* 0.11.0 - Automatically fix some rule violations
* 0.10.0 - Ignore comments/TOML, improved rules
* 0.9.0 - Nested .markdownlint.json config
* 0.8.0 - Improved rules, shareable config
* 0.7.0 - New/improved rules, more details
* 0.6.0 - Improved rules and underlining
* 0.5.0 - New/improved rules, schema for settings
* 0.4.0 - Throttle linting
* 0.3.0 - Focused underlining
* 0.2.0 - Custom configuration
* 0.1.0 - Initial release
## About release 0.40.0
Originally, this extension called into the [`markdownlint`](https://github.com/DavidAnson/markdownlint) library and needed to reimplement support for shared concepts like configuration files, etc.. With this release, the extension calls into [`markdownlint-cli2`](https://github.com/DavidAnson/markdownlint-cli2) to perform linting. This brings complete support for everything that tool supports, including the powerful `.markdownlint-cli2.{jsonc,yaml,js}` format that allows configuration inheritance along with different rules, custom rules, and [`markdown-it` plugins](https://www.npmjs.com/search?q=keywords:markdown-it-plugin) for each directory. This change means a few things behave differently or are no longer supported:
* The default configuration (to disable `MD013`/`line-length`) is allowed to propagate into an open project even if that project has its own configuration. (This was partially true before.) To change behavior within a project (e.g., for complete consistency with CLI behavior) do so explicitly with any of the configuration mechanisms (for example, via `"line-length": true`).
* The `.markdownlintrc` configuration file is no longer used. This format was supported for consistency with [`markdownlint-cli`](https://github.com/igorshubovych/markdownlint-cli) and was only partially implemented. Any of the configuration file formats used by `markdownlint-cli2` can be used instead.
* The "Open this document's configuration" action is no longer present in VS Code. This feature attempted to determine the single configuration source for the current file, but now that configuration inheritance is supported, there may no longer be a single configuration file.
* The `markdownlint.customRulesAlwaysAllow` setting is no longer used because custom rules (along with `markdown-it` plugins, `.markdownlint.cjs`, and `.markdownlint-cli2.cjs`) are automatically loaded by `markdownlint-cli2`. To prevent running external JavaScript like this, set the new `markdownlint.blockJavaScript` configuration to `true` in VS Code's user settings.
* Custom rule paths specified by the `markdownlint.customRules` setting must begin with `./` when they are relative paths (this was previously optional).
<!-- markdownlint-disable-file required-headings -->

21
vscode/extensions/davidanson.vscode-markdownlint-0.47.0/LICENSE.txt Normal file
View File

@@ -0,0 +1,21 @@
The MIT License (MIT)
Copyright (c) 2015-2022 David Anson
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.

385
vscode/extensions/davidanson.vscode-markdownlint-0.47.0/README.md Normal file
View File

@@ -0,0 +1,385 @@
# markdownlint
> Markdown/CommonMark linting and style checking for Visual Studio Code
## Introduction
The [Markdown](https://en.wikipedia.org/wiki/Markdown) markup language is designed to be easy to read, write, and understand. It succeeds - and its flexibility is both a benefit and a drawback. Many styles are possible, so formatting can be inconsistent. Some constructs don't work well in all parsers and should be avoided. For example, [here are some common/troublesome Markdown constructs](https://gist.github.com/DavidAnson/006a6c2a2d9d7b21b025).
[markdownlint](https://marketplace.visualstudio.com/items?itemName=DavidAnson.vscode-markdownlint) is an extension for the [Visual Studio Code editor](https://code.visualstudio.com) that includes a library of rules to encourage standards and consistency for Markdown files. It is powered by the [markdownlint library for Node.js](https://github.com/DavidAnson/markdownlint) (which was inspired by [markdownlint for Ruby](https://github.com/mivok/markdownlint)). Linting is performed by the [`markdownlint-cli2` engine](https://github.com/DavidAnson/markdownlint-cli2), which can be used in conjunction with this extension to provide command-line support for scripts and continuous integration scenarios. The [`markdownlint-cli2-action` GitHub Action](https://github.com/marketplace/actions/markdownlint-cli2-action) uses the same engine and can be integrated with project workflows.
## Install
1. Open [Visual Studio Code](https://code.visualstudio.com/)
2. Press `Ctrl+P`/`⌘P` to open the Quick Open dialog
3. Type `ext install markdownlint` to find the extension
4. Click the `Install` button, then the `Enable` button
OR
1. Press `Ctrl+Shift+X`/`⇧⌘X` to open the Extensions tab
2. Type `markdownlint` to find the extension
3. Click the `Install` button, then the `Enable` button
OR
1. Open a command-line prompt
2. Run `code --install-extension DavidAnson.vscode-markdownlint`
## Use
When editing a Markdown file in Code with `markdownlint` installed, any lines that violate one of `markdownlint`'s rules (see below) will trigger a *Warning* in the editor. Warnings are indicated by a wavy green underline and can also be seen by pressing `Ctrl+Shift+M`/`⇧⌘M` to open the Errors and Warnings dialog. Hover the mouse pointer over a green line to see the warning or press `F8` and `Shift+F8`/`⇧F8` to cycle through all the warnings (markdownlint warnings all begin with `MD###`). For more information about a `markdownlint` warning, place the cursor on a line and click the light bulb icon or press `Ctrl+.`/`⌘.` to open the quick fix dialog. Clicking one of the warnings in the dialog will display that rule's help entry in the default web browser.
> For a tutorial, please see [Build an Amazing Markdown Editor Using Visual Studio Code and Pandoc](https://thisdavej.com/build-an-amazing-markdown-editor-using-visual-studio-code-and-pandoc/) by Dave Johnson.
## Rules
* **[MD001](https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md001)** *heading-increment/header-increment* - Heading levels should only increment by one level at a time
* ~~**[MD002](https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md002)** *first-heading-h1/first-header-h1* - First heading should be a top level heading~~
* **[MD003](https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md003)** *heading-style/header-style* - Heading style
* **[MD004](https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md004)** *ul-style* - Unordered list style
* **[MD005](https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md005)** *list-indent* - Inconsistent indentation for list items at the same level
* ~~**[MD006](https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md006)** *ul-start-left* - Consider starting bulleted lists at the beginning of the line~~
* **[MD007](https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md007)** *ul-indent* - Unordered list indentation
* **[MD009](https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md009)** *no-trailing-spaces* - Trailing spaces
* **[MD010](https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md010)** *no-hard-tabs* - Hard tabs
* **[MD011](https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md011)** *no-reversed-links* - Reversed link syntax
* **[MD012](https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md012)** *no-multiple-blanks* - Multiple consecutive blank lines
* **[MD013](https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md013)** *line-length* - Line length
* **[MD014](https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md014)** *commands-show-output* - Dollar signs used before commands without showing output
* **[MD018](https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md018)** *no-missing-space-atx* - No space after hash on atx style heading
* **[MD019](https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md019)** *no-multiple-space-atx* - Multiple spaces after hash on atx style heading
* **[MD020](https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md020)** *no-missing-space-closed-atx* - No space inside hashes on closed atx style heading
* **[MD021](https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md021)** *no-multiple-space-closed-atx* - Multiple spaces inside hashes on closed atx style heading
* **[MD022](https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md022)** *blanks-around-headings/blanks-around-headers* - Headings should be surrounded by blank lines
* **[MD023](https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md023)** *heading-start-left/header-start-left* - Headings must start at the beginning of the line
* **[MD024](https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md024)** *no-duplicate-heading/no-duplicate-header* - Multiple headings with the same content
* **[MD025](https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md025)** *single-title/single-h1* - Multiple top level headings in the same document
* **[MD026](https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md026)** *no-trailing-punctuation* - Trailing punctuation in heading
* **[MD027](https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md027)** *no-multiple-space-blockquote* - Multiple spaces after blockquote symbol
* **[MD028](https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md028)** *no-blanks-blockquote* - Blank line inside blockquote
* **[MD029](https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md029)** *ol-prefix* - Ordered list item prefix
* **[MD030](https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md030)** *list-marker-space* - Spaces after list markers
* **[MD031](https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md031)** *blanks-around-fences* - Fenced code blocks should be surrounded by blank lines
* **[MD032](https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md032)** *blanks-around-lists* - Lists should be surrounded by blank lines
* **[MD033](https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md033)** *no-inline-html* - Inline HTML
* **[MD034](https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md034)** *no-bare-urls* - Bare URL used
* **[MD035](https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md035)** *hr-style* - Horizontal rule style
* **[MD036](https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md036)** *no-emphasis-as-heading/no-emphasis-as-header* - Emphasis used instead of a heading
* **[MD037](https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md037)** *no-space-in-emphasis* - Spaces inside emphasis markers
* **[MD038](https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md038)** *no-space-in-code* - Spaces inside code span elements
* **[MD039](https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md039)** *no-space-in-links* - Spaces inside link text
* **[MD040](https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md040)** *fenced-code-language* - Fenced code blocks should have a language specified
* **[MD041](https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md041)** *first-line-heading/first-line-h1* - First line in file should be a top level heading
* **[MD042](https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md042)** *no-empty-links* - No empty links
* **[MD043](https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md043)** *required-headings/required-headers* - Required heading structure
* **[MD044](https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md044)** *proper-names* - Proper names should have the correct capitalization
* **[MD045](https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md045)** *no-alt-text* - Images should have alternate text (alt text)
* **[MD046](https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md046)** *code-block-style* - Code block style
* **[MD047](https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md047)** *single-trailing-newline* - Files should end with a single newline character
* **[MD048](https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md048)** *code-fence-style* - Code fence style
* **[MD049](https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md049)** *emphasis-style* - Emphasis style should be consistent
* **[MD050](https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md050)** *strong-style* - Strong style should be consistent
See [markdownlint's Rules.md file](https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md) for more details.
The following rules can be automatically fixed by moving the cursor to a rule violation (wavy underlined text) and typing `Ctrl+.`/`⌘.` or clicking the light bulb icon.
* MD004 *ul-style*
* MD005 *list-indent*
* MD006 *ul-start-left*
* MD007 *ul-indent*
* MD009 *no-trailing-spaces*
* MD010 *no-hard-tabs*
* MD011 *no-reversed-links*
* MD012 *no-multiple-blanks*
* MD014 *commands-show-output*
* MD018 *no-missing-space-atx*
* MD019 *no-multiple-space-atx*
* MD020 *no-missing-space-closed-atx*
* MD021 *no-multiple-space-closed-atx*
* MD022 *blanks-around-headings*
* MD023 *heading-start-left*
* MD026 *no-trailing-punctuation*
* MD027 *no-multiple-space-blockquote*
* MD030 *list-marker-space*
* MD031 *blanks-around-fences*
* MD032 *blanks-around-lists*
* MD034 *no-bare-urls*
* MD037 *no-space-in-emphasis*
* MD038 *no-space-in-code*
* MD039 *no-space-in-links*
* MD044 *proper-names*
* MD047 *single-trailing-newline*
* MD049 *emphasis-style*
* MD050 *strong-style*
## Commands
### Fix
All of a document's violations of the above rules can be fixed automatically.
`markdownlint` registers itself as a [source code formatter](https://code.visualstudio.com/docs/editor/codebasics#_formatting) for Markdown files and can be invoked by the `Format Document`/`editor.action.formatDocument` and `Format Selection`/`editor.action.formatSelection` commands, either from the [Command Palette](https://code.visualstudio.com/docs/getstarted/userinterface#_command-palette) (via `View|Command Palette...` or `Ctrl+Shift+P`/`⇧⌘P`) or via the default key bindings of `Shift+Alt+F`/`⇧⌥F` (to format the document) and `Ctrl+K Ctrl+F`/`⌘K ⌘F` (to format the selection).
To automatically format when saving or pasting into a Markdown document, [configure Visual Studio Code's `editor.formatOnSave` or `editor.formatOnPaste` settings](https://code.visualstudio.com/docs/getstarted/settings) like so:
```json
"[markdown]": {
"editor.formatOnSave": true,
"editor.formatOnPaste": true
},
```
`markdownlint` also contributes the `markdownlint.fixAll` command which fixes a document's violations in one step and can be run from the Command Palette or by [binding the command to a keyboard shortcut](https://code.visualstudio.com/docs/getstarted/keybindings).
To automatically fix violations when saving a Markdown document, configure Visual Studio Code's `editor.codeActionsOnSave` setting like so:
```json
"editor.codeActionsOnSave": {
"source.fixAll.markdownlint": true
}
```
Automatically-applied fixes from either method can be reverted by `Edit|Undo` or `Ctrl+Z`/`⌘Z`.
### Workspace
To lint all Markdown files in the current workspace, run the `markdownlint.lintWorkspace` command (from the Command Palette or by binding it to a keyboard shortcut).
This will use [`markdownlint-cli2`](https://github.com/DavidAnson/markdownlint-cli2), the same engine that powers the extension, to lint all files and output the results to a new terminal in the "Terminal" panel.
Results will also appear in the "Problems" panel (`Ctrl+Shift+M`/`⇧⌘M`) because of the [problem matcher](https://code.visualstudio.com/docs/editor/tasks#_defining-a-problem-matcher) included with the extension.
Entries in the "Problems" panel can be clicked to open the corresponding file in the editor.
To customize the files that are included/excluded when linting a workspace, configure the `markdownlint.lintWorkspaceGlobs` setting (see below) at workspace or user scope.
### Disable
To temporarily disable linting of Markdown documents, run the `markdownlint.toggleLinting` command (from the Command Palette or by binding it to a keyboard shortcut). To re-enable linting, run the `markdownlint.toggleLinting` command again.
> **Note**: The effects of the `markdownlint.toggleLinting` command are reset when a new workspace is opened; linting defaults to enabled.
## Configure
### markdownlint.config
The default rule configuration disables [`MD013`/`line-length`](https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md013) because many files include lines longer than the conventional 80 character limit:
```json
{
"MD013": false
}
```
> **Note**: `MD002`/`first-heading-h1` and `MD006`/`ul-start-left` are also disabled because they have been deprecated in the `markdownlint` library.
Rules can be enabled, disabled, and customized by creating a [JSON](https://en.wikipedia.org/wiki/JSON) file named `.markdownlint.jsonc`/`.markdownlint.json` or a [YAML](https://en.wikipedia.org/wiki/YAML) file named `.markdownlint.yaml`/`.markdownlint.yml` or a [JavaScript](https://en.wikipedia.org/wiki/JavaScript) file named `.markdownlint.cjs` in any directory of a project.
Additionally, options (which include rules and things like [`markdown-it` plugins](https://www.npmjs.com/search?q=keywords:markdown-it-plugin) and other settings) can be configured by creating a JSON file named `.markdownlint-cli2.jsonc` or a YAML file named `.markdownlint-cli2.yaml` or a JavaScript file named `.markdownlint-cli2.cjs` in any directory of a project. For more information about configuration file precedence and complete examples, see the [Configuration section of the markdownlint-cli2 README.md](https://github.com/DavidAnson/markdownlint-cli2#configuration).
> **Note**: When no folder is open, configuration and options are loaded from the user's home directory (e.g., `%USERPROFILE%` on Windows or `$HOME` on macOS/Linux).
> Because JavaScript code is cached after being loaded, edits to `.markdownlint.cjs` and `.markdownlint-cli2.cjs` require a restart of VS Code.
A custom configuration is often defined by a `.markdownlint.json` file in the root of the project:
```json
{
"default": true,
"MD003": { "style": "atx_closed" },
"MD007": { "indent": 4 },
"no-hard-tabs": false
}
```
To extend another configuration file, such a file can use the `extends` property to provide a relative path:
```json
{
"extends": "../.markdownlint.json",
"no-hard-tabs": true
}
```
Files referenced via `extends` do not need to be part of the current project (but usually are).
Rules can also be configured using Code's support for [user and workspace settings](https://code.visualstudio.com/docs/customization/userandworkspace).
The above configuration might look like the following in Code's user settings file:
```json
{
"editor.someSetting": true,
"markdownlint.config": {
"default": true,
"MD003": { "style": "atx_closed" },
"MD007": { "indent": 4 },
"no-hard-tabs": false
}
}
```
File paths referenced by `extends` from user settings are resolved relative to the user's home directory (e.g., `%USERPROFILE%` on Windows or `$HOME` on macOS/Linux). File paths referenced by `extends` from workspace settings are resolved relative to the workspace folder. File paths referenced by `extends` from within the workspace are resolved relative to the file itself.
Configuration sources have the following precedence (in decreasing order):
* `.markdownlint-cli2.{jsonc,yaml,js}` file in the same or parent directory
* `.markdownlint.{jsonc,json,yaml,yml,js}` file in the same or parent directory
* Visual Studio Code user/workspace settings
* Default configuration (see above)
Configuration changes saved to any location take effect immediately. Files referenced via `extends` are not monitored for changes. Inherited configuration can be explicitly disabled (or re-enabled) in any configuration file.
When a workspace is open, running the `markdownlint.openConfigFile` command (from the Command Palette or by binding it to a keyboard shortcut) will open an editor for the `.markdownlint.{jsonc,json,yaml,yml,js}` configuration file in the root of the workspace. If none of these files exist, a new `.markdownlint.json` containing the default rule configuration will be opened in the editor in the "pending save" state.
### markdownlint.focusMode
By default, all linting issues are logged and highlighted as you type or edit a document. This includes "transient" issues like `MD009`/`no-trailing-spaces` such as when typing at the end of a line.
If you find this distracting, linting can be configured to ignore issues on the same line as the cursor. This looks like the following in Code's user settings:
```json
{
"editor.someSetting": true,
"markdownlint.focusMode": true
}
```
To ignore issues on the *N* lines above and below the cursor, set `focusMode` to a positive integer representing the number of lines to ignore in each direction:
```json
{
"editor.someSetting": true,
"markdownlint.focusMode": 2
}
```
The value of `2` in the example above will ignore issues on the line with the cursor, the 2 lines above it, and the 2 lines below it.
> **Note**: This is an application-level setting and is only valid in user (not workspace) settings.
### markdownlint.run
By default, linting is performed as you type or edit a document. Linting is fast and efficient and should not interfere with typical workflows.
If you find this distracting, linting can be configured to run only when the document is saved. This looks like the following in Code's user settings:
```json
{
"editor.someSetting": true,
"markdownlint.run": "onSave"
}
```
> **Note**: When configured to run `onSave`, the list of reported issues will become outdated while the document is edited and will update when the document is saved.
### markdownlint.ignore
If a workspace contains generated content or other Markdown files that trigger warnings but cannot be fixed, it may be helpful to ignore (skip) those files when linting. This can be done by creating a file named `.markdownlintignore` in the root of the project or by updating the user/workspace configuration's `markdownlint.ignore` setting with an array of glob expressions matching the relevant file names. Alternatively, the `markdownlint.ignore` setting can be a string identifying a file to use instead of `.markdownlintignore`.
When using a `.markdownlintignore` file (or overriding it), the content of the file follows the rules for [gitignore](https://git-scm.com/docs/gitignore) and may look something like:
```ini
# Ignore Markdown files in the test directory
test/*.md
!test/except/this/one.md
```
An example of using Code's workspace configuration to ignore files by glob might be:
```json
{
"editor.someSetting": true,
"markdownlint.ignore": [
"ignore.md",
"directory/ignore.md",
"**/ignore.md",
"**/*.md"
]
}
```
Or to ignore files by referencing a different file:
```json
{
"editor.someSetting": true,
"markdownlint.ignore": ".gitignore"
}
```
The globbing library used for matching `markdownlint.ignore` array values is [minimatch](https://github.com/isaacs/minimatch) with the `dot` and `nocomment` options enabled. Matching is case-sensitive and paths are resolved relative to the root of the workspace. The directory separator is `/`, even on Windows.
> **Note**: Files can also be ignored (in a way other tools will recognize) via the `ignores` property in `.markdownlint-cli2.{jsonc,yaml,js}`.
### markdownlint.customRules
Custom rules can be specified in Code's user/workspace configuration to apply additional linting beyond the default set of rules. Custom rules are specified by the path to a JavaScript file or the name of or path to an [npm](https://www.npmjs.com/) package exporting one rule or an array of rules ([examples of custom rules](https://www.npmjs.com/search?q=keywords:markdownlint-rule)).
Paths are typically relative to the root of the current workspace (or the user's home directory when no folder is open) and should begin with `./` to [differentiate the relative path from a module identifier](https://nodejs.org/dist/latest-v14.x/docs/api/modules.html#modules_file_modules). Paths can be absolute and begin with `/`, though this is discouraged because it does not work reliably across different machines. If implementing custom rules in a workspace, consider committing the rule code under the `.vscode` directory where it will be separate from other workspace content and available to everyone who clones the repository. Paths of the form `{extension}/path` are relative to the base directory of the Code extension named `extension` (which must already be installed). This syntax allows custom rules to be included within another extension's package, though this is discouraged because it introduces a subtle dependency on the other extension.
An example of Code's workspace settings for custom rules might look like the following:
```json
{
"editor.someSetting": true,
"markdownlint.customRules": [
"./.vscode/my-custom-rule.js",
"./.vscode/my-custom-rule-array.js",
"./.vscode/npm-package-for-custom-rule",
"/absolute/path/to/custom/rule.js",
"{publisher.extension-name}/custom-rule.js",
"{publisher.extension-name}/npm/rule/package"
]
}
```
For information about authoring custom rules, see [the `markdownlint` documentation for custom rules](https://github.com/DavidAnson/markdownlint/blob/main/doc/CustomRules.md).
> **Note**: Custom rules can also be specified (in a way other tools will recognize) via the `customRules` property in `.markdownlint-cli2.{jsonc,yaml,js}`.
### markdownlint.lintWorkspaceGlobs
The standard globs used when linting a workspace should match VS Code's default concept of "Markdown files that matter":
```json
[
// Source: https://github.com/microsoft/vscode/blob/main/extensions/markdown-basics/package.json
"**/*.{md,mkd,mdwn,mdown,markdown,markdn,mdtxt,mdtext,workbook}",
// Source: https://github.com/microsoft/vscode/blob/main/src/vs/workbench/contrib/search/browser/search.contribution.ts
"!**/node_modules",
"!**/bower_components",
// Additional exclusions
"!**/.git"
]
```
This list can be customized at workspace or user scope to include and exclude additional files and directories.
For more information about syntax, see the ["Command Line" section of the markdownlint-cli2 documentation](https://github.com/DavidAnson/markdownlint-cli2#command-line).
## Suppress
Individual warnings can be suppressed with comments in the Markdown file itself:
```md
<!-- markdownlint-disable MD037 -->
deliberate space * in * emphasis
<!-- markdownlint-enable MD037 -->
```
More information about inline suppressions can be found in the [Configuration section of the `markdownlint` README.md](https://github.com/DavidAnson/markdownlint#configuration).
## Snippets
The following snippets are available when editing a Markdown document (press `Ctrl+Space`/`⌃Space` for IntelliSense suggestions):
* `markdownlint-disable`
* `markdownlint-enable`
* `markdownlint-disable-next-line`
* `markdownlint-capture`
* `markdownlint-restore`
* `markdownlint-disable-file`
* `markdownlint-enable-file`
* `markdownlint-configure-file`
## Security
Running JavaScript from custom rules, `markdown-it` plugins, or configuration files (such as `.markdownlint.cjs` and `.markdownlint-cli2.cjs`) could be a security risk, so VS Code's [Workspace Trust setting](https://code.visualstudio.com/docs/editor/workspace-trust) is honored to block JavaScript for untrusted workspaces.
## History
See [CHANGELOG.md](https://github.com/DavidAnson/vscode-markdownlint/blob/HEAD/CHANGELOG.md).

37
vscode/extensions/davidanson.vscode-markdownlint-0.47.0/bundle.js Normal file
View File

File diff suppressed because one or more lines are too long

1
vscode/extensions/davidanson.vscode-markdownlint-0.47.0/bundle.web.js Normal file
View File

File diff suppressed because one or more lines are too long

BIN
vscode/extensions/davidanson.vscode-markdownlint-0.47.0/images/markdownlint-128.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 920 B

102
vscode/extensions/davidanson.vscode-markdownlint-0.47.0/markdownlint-cli2-config-schema.json Normal file
View File

@@ -0,0 +1,102 @@
{
"$schema": "http://json-schema.org/draft-07/schema#",
"title": "markdownlint-cli2 configuration schema",
"type": "object",
"properties": {
"config": {
"$ref": "./markdownlint-config-schema.json"
},
"customRules": {
"description": "Module names or paths of custom rules to load and use when linting",
"type": "array",
"default": [],
"items": {
"description": "Module name or path of a custom rule",
"type": "string",
"minLength": 1
}
},
"fix": {
"description": "Whether to enable fixing of linting errors reported by rules that emit fix information",
"type": "boolean",
"default": false
},
"frontMatter": {
"description": "Regular expression used to match and ignore any front matter at the beginning of a document",
"type": "string",
"minLength": 1,
"default": ""
},
"globs": {
"description": "Glob expressions to include when linting (only valid at the root)",
"type": "array",
"default": [],
"items": {
"description": "Glob expression of files to lint",
"type": "string",
"minLength": 1
}
},
"ignores": {
"description": "Glob expressions to ignore when linting",
"type": "array",
"default": [],
"items": {
"description": "Glob expression of files to ignore",
"type": "string",
"minLength": 1
}
},
"markdownItPlugins": {
"description": "markdown-it plugins to load and use when linting",
"type": "array",
"default": [],
"items": {
"description": "Name or path of a markdown-it plugin followed by parameters",
"type": "array",
"items": [
{
"description": "Name or path of a markdown-it plugin",
"type": "string",
"minLength": 1
},
{
"description": "Parameter(s) to pass to the markdown-it plugin"
}
],
"minItems": 1
}
},
"noInlineConfig": {
"description": "Whether to disable support of HTML comments within Markdown content",
"type": "boolean",
"default": false
},
"noProgress": {
"description": "Whether to disable the display of progress on stdout (only valid at the root)",
"type": "boolean",
"default": false
},
"outputFormatters": {
"description": "Output formatters to load and use to customize markdownlint-cli2 output (only valid at the root)",
"type": "array",
"default": [],
"items": {
"description": "Name or path of an output formatter followed by parameters",
"type": "array",
"items": [
{
"description": "Name or path of an output formatter",
"type": "string",
"minLength": 1
},
{
"description": "Parameter(s) to pass to the output formatter"
}
],
"minItems": 1
}
}
},
"additionalProperties": false
}

1663
vscode/extensions/davidanson.vscode-markdownlint-0.47.0/markdownlint-config-schema.json Normal file
View File

File diff suppressed because it is too large Load Diff

1902
vscode/extensions/davidanson.vscode-markdownlint-0.47.0/package.json Normal file
View File

File diff suppressed because it is too large Load Diff

46
vscode/extensions/davidanson.vscode-markdownlint-0.47.0/snippets.json Normal file
View File

@@ -0,0 +1,46 @@
{
"insertMarkdownLintDisableComment": {
"prefix": "markdownlint-disable",
"body": "<!-- markdownlint-disable ${1:MD000 }-->",
"description": "Disables one or more rules by name (MD013), alias (line-length), or tag (whitespace). Multiple rules are space-delimited (MD018 MD019). If no rules are specified, all rules are disabled. Takes effect starting with the line the comment is on."
},
"insertMarkdownLintEnableComment": {
"prefix": "markdownlint-enable",
"body": "<!-- markdownlint-enable ${1:MD000 }-->",
"description": "Enables one or more rules by name (MD013), alias (line-length), or tag (whitespace). Multiple rules are space-delimited (MD018 MD019). If no rules are specified, all rules are enabled. Takes effect starting with the line the comment is on."
},
"insertMarkdownLintDisableFileComment": {
"prefix": "markdownlint-disable-file",
"body": "<!-- markdownlint-disable-file ${1:MD000 }-->",
"description": "Disables one or more rules by name (MD013), alias (line-length), or tag (whitespace). Multiple rules are space-delimited (MD018 MD019). If no rules are specified, all rules are disabled. Applies to the entire file."
},
"insertMarkdownLintEnableFileComment": {
"prefix": "markdownlint-enable-file",
"body": "<!-- markdownlint-enable-file ${1:MD000 }-->",
"description": "Enables one or more rules by name (MD013), alias (line-length), or tag (whitespace). Multiple rules are space-delimited (MD018 MD019). If no rules are specified, all rules are enabled. Applies to the entire file."
},
"insertMarkdownLintDisableNextLineComment": {
"prefix": "markdownlint-disable-next-line",
"body": "<!-- markdownlint-disable-next-line ${1:MD000 }-->",
"description": "Disables one or more rules by name (MD013), alias (line-length), or tag (whitespace). Multiple rules are space-delimited (MD018 MD019). If no rules are specified, all rules are disabled. Applies to the next line only."
},
"insertMarkdownLintCaptureComment": {
"prefix": "markdownlint-capture",
"body": "<!-- markdownlint-capture -->",
"description": "Captures the current rule configuration. Takes effect starting with the line the comment is on."
},
"insertMarkdownLintRestoreComment": {
"prefix": "markdownlint-restore",
"body": "<!-- markdownlint-restore -->",
"description": "Restores the most recently captured rule configuration. Defaults to the document's initial configuration. Takes effect starting with the line the comment is on."
},
"insertMarkdownLintConfigureFileComment": {
"prefix": "markdownlint-configure-file",
"body": "<!-- markdownlint-configure-file { ${1:\"MD013\": { \"line_length\": 100 \\}} } -->",
"description": "Configures one or more rules by name (MD013), alias (line-length), or tag (whitespace) using the same JSON format as the \"markdownlint.config\" object. Applies to the entire file."
}
}