# @343dev/markdown-lint 中文文档

规范地址：https://npmcn.com/package/%40343dev/markdown-lint/

版本：3\.0\.1
npm 元数据更新时间：2024-08-07T08:24:19.332Z
中文译文更新时间：2026-11-08T01:48:19.209Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40343dev/markdown-lint
原文对照：https://npmcn.com/package/%40343dev/markdown-lint/?lang=original
项目主页：https://github.com/343dev/markdown-lint#readme
源码仓库：https://github.com/343dev/markdown-lint

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：24.1 kB，12 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=16
- 运行依赖：9 个
- 首次发布：2023-09-03T19:25:25.746Z
- 最新版本发布：2024-08-07T08:24:19.168Z
- 近 30 天下载量：1929（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：3（近 12 个月 0 个）

## 中文简介

标记下代码样式 linter

## 安装

```sh
npm install @343dev/markdown-lint
```

也可以使用：`pnpm add @343dev/markdown-lint`、`yarn add @343dev/markdown-lint`、`bun add @343dev/markdown-lint`

## README

# @ 343dev/markdown-lint (英语)

![Аватар: Яркое градиентное лого Markdown со звёздочкой](https://npmcn.com/package/%40343dev/markdown-lint/logo.png)

[![npm](https://img.shields.io/npm/v/@343dev/markdown-lint.svg)](https://www.npmjs.com/package/@343dev/markdown-lint)

{\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你还好吧 стандартам.

Основана [高级](https://github.com/prettier/prettier), (中文(简体) ), [备注](https://github.com/remarkjs/remark) и [泰波格拉夫( 泰波格拉夫 )](https://github.com/typograf/typograf)。 。 。 .

## Мотивация

{\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 документацией. {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}我.. {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}你觉得呢 [语言工具-节点](https://github.com/343dev/languagetool-node)。 。 。 .

{\\fn黑体\\fs20\\shad2\\2aH82\\3aH20\\4aH33\\fscx95\\3cH592001\\be1}你觉得呢? 马克倒... .. JS,CSS и иные. {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢.

## Установка

校对:Soup

```bash
npm install -g @343dev/markdown-lint
```

{\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢

```bash
npm install --dev @343dev/markdown-lint
```

## \================================================================================================================================================================

{\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 `markdown-lint` из 校对:soup

```bash
# проверка файла на наличие ошибок
markdown-lint README.md

# проверка файлов внутри директории (без поиска в поддиректориях)
markdown-lint ./docs

# проверка файлов внутри директории (с поиском в поддиректориях)
markdown-lint -r ./docs

# проверка файла и автоматическое исправление ошибок
markdown-lint --fix README.md
```

### Доступные

-   `--fix` - исправление ошибок;
-   `--ext <value>` - указание;допустимо указание,например也 `--ext apib --ext txt`По `md`· ;
-   `-t, --typograph` - типографирование;
-   `-r, --recursive` - поиск не указанной директории директории директории во всех;
-   `-c, --config <file>` - внешнего с;
-   `-v, --version` - текущей версии;
-   `-h, --help` ——вывод.

## Конфигурация

{\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 [评论](https://github.com/remarkjs/remark)。 。 。 .

{\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 [备注](https://github.com/remarkjs/remark-lint) {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}你觉得呢 [注释预设- lint- markdown- system- 指南](https://github.com/remarkjs/remark-lint/tree/main/packages/remark-preset-lint-markdown-style-guide#rules)。 。 。 .

{\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 `--config` 说吧

```bash
markdown-lint --fix --config ~/.markdownlintrc.cjs README.md
```

校对:Soup

```javascript
module.exports = {
  // prettier обрабатывает тексты, когда `--fix` передан
  prettier: {
    // автоматически ограничиваем длину строки в 120 символов
    printWidth: '120'
  },

  remark: {
    // применяем настройки для remark-lint
    plugins: [
      // объявляем линтеру, что максимальная длина строки теперь равна 120 символам
      ['remark-lint-maximum-line-length', 120],

      // отключаем правило `no-inline-padding`
      ['remark-lint-no-inline-padding', false],

      // объявляем линтеру, что мы теперь используем `*` как маркер списка
      ['remark-lint-unordered-list-marker-style', '*']
    ],

    // remark-stringify обрабатывает тексты, когда `--fix` передан
    stringifySettings: {
      // автоматически заменяем все маркеры списка на `*`
      bullet: '*'
    }
  },

  typograf: {
    // API настроек — https://github.com/typograf/typograf/blob/dev/docs/api_rules.md
    // список правил — https://github.com/typograf/typograf/blob/dev/docs/RULES.ru.md
    locale: ['ru', 'en-US'],
    enableRules: [],
    disableRules: [
      // обязательное отключение следующих правил требуется для правильной работы типографа
      'common/space/delTrailingBlanks',
      'common/space/trimLeft',
      'common/space/trimRight'
    ],
    rulesSettings: []
  }
};
```

## Пример

### {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 `--fix`

```markdown
Linux kernel
============

There are several guides for kernel developers and users. These guides can be rendered in a number of formats, like HTML and PDF. Please read Documentation/admin-guide/README.rst first.

In order to build the documentation, use ``make htmldocs`` or ``make pdfdocs``.  The formatted documentation can also be read online at:

    https://www.kernel.org/doc/html/latest/

There are various text files in the Documentation/ subdirectory, several of them using the Restructured Text markup notation.

Please read the Documentation/process/changes.rst file, as it contains the requirements for building and running the kernel, and information about the problems which may result by upgrading your kernel.

__Useful links__

* [Linux kernel licensing rules](https://www.kernel.org/doc/html/latest/process/license-rules.html#kernel-licensing)
* [Reporting bugs](https://www.kernel.org/doc/html/latest/admin-guide/reporting-bugs.html)
```

### После

````markdown
# Linux kernel

There are several guides for kernel developers and users. These guides can be
rendered in a number of formats, like HTML and PDF. Please read
Documentation/admin-guide/README.rst first.

In order to build the documentation, use `make htmldocs` or `make pdfdocs`. The
formatted documentation can also be read online at:

```
https://www.kernel.org/doc/html/latest/
```

There are various text files in the Documentation/ subdirectory, several of them
using the Restructured Text markup notation.

Please read the Documentation/process/changes.rst file, as it contains the
requirements for building and running the kernel, and information about the
problems which may result by upgrading your kernel.

**Useful links**

- [Linux kernel licensing rules](https://www.kernel.org/doc/html/latest/process/license-rules.html#kernel-licensing)
- [Reporting bugs](https://www.kernel.org/doc/html/latest/admin-guide/reporting-bugs.html)
````

## Благодарности

{\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 [Игорь](https://pandabanda.com/)。 。 。 .

## 常见问题

### @343dev/markdown-lint 是什么？

标记下代码样式 linter

### 如何安装 @343dev/markdown-lint？

在项目目录运行 npm install @343dev/markdown-lint，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 markdown-lint，可以用 npx markdown-lint 直接运行。

### @343dev/markdown-lint 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/343dev\_\_markdown-lint 是否存在。

### @343dev/markdown-lint 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @343dev/markdown-lint 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=16。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @343dev/markdown-lint 可以商用吗？

@343dev/markdown-lint 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @343dev/markdown-lint 的下载量有多少？

根据 npm 官方下载统计，@343dev/markdown-lint 在 2026/10/05 – 2026/11/03 这 30 天内被下载 1,929 次，日均约 64 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @343dev/markdown-lint 还在维护吗？

最新版本 3\.0\.1 发布于 2024/08/07（2 年前）；至今共发布 3 个版本，其中过去 12 个月发布了 0 个；首次发布于 2023/09/04。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。