{"id":26046,"library":"open-md-checker","title":"open-md-checker","description":"Open-md-checker is an open-source, extensible markdown linting tool available as a global npm module (v1.2.3). It checks markdown files for formatting issues using configurable rules from the remark-lint ecosystem. Key differentiators include support for custom rule files, integration with .gitignore, configuration via package.json or environment variables, and optional Docker usage. It offers a flexible Config interface with patterns and options for ignoring files. The tool is stable but has limited recent updates compared to alternatives like markdownlint.","status":"active","version":"1.2.3","language":"javascript","source_language":"en","source_url":null,"tags":["javascript"],"install":[{"cmd":"npm install open-md-checker","lang":"bash","label":"npm"},{"cmd":"yarn add open-md-checker","lang":"bash","label":"yarn"},{"cmd":"pnpm add open-md-checker","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"For file pattern matching and ignoring files based on .gitignore or package.json configuration.","package":"deglob","optional":false},{"reason":"Core linting engine, although not explicitly listed in dependencies, is used via the default requires file.","package":"remark-lint","optional":false}],"imports":[{"note":"Use npx to run without global install; the package is designed as a CLI tool, not a library.","wrong":"open-md-checker","symbol":"CLI","correct":"npx open-md-checker"},{"note":"Config type is available for TypeScript users; no default export for programmatic use.","wrong":"","symbol":"Config","correct":"import type { Config } from 'open-md-checker'"},{"note":"No direct API export; configuration is read from files or environment, not imported.","wrong":"import defaults from 'open-md-checker'","symbol":"default configuration","correct":"const config = require('open-md-checker/defaults');"}],"quickstart":{"code":"# Install globally\nnpm install -g open-md-checker\n# Create a markdown file with issues\necho '## Title' > test.md\n# Run the linter\nopen-md-checker\n# Or use configuration via environment\nMD_LINT_CONFIG_PATH=./open-md-checker.json open-md-checker","lang":"shell","description":"Shows global install and usage, including environment variable for custom config."},"warnings":[{"fix":"Use the correct structure: { 'open-md-checker': { patterns: ['**/*.md'], options: {} } }","message":"Configuration must be placed under 'open-md-checker' key in package.json; reading from a plain config file requires MD_LINT_CONFIG_PATH environment variable.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Use absolute paths or ensure the file exports an array of remark-lint rules.","message":"Custom rules via 'requires' field must be in a CommonJS module (module.exports = [...]); relative paths are resolved from cwd.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Consider migrating to markdownlint-cli2 for more features and active maintenance.","message":"The package is stable but not actively developed; newer alternatives like markdownlint-cli2 exist.","severity":"deprecated","affected_versions":">=1.0.0"}],"env_vars":null,"search_vec":"'altern':86 'avail':18 'check':26 'checker':4,8 'compar':84 'config':66 'configur':33,52 'custom':46 'differenti':42 'docker':60 'ecosystem':40 'environ':56 'extens':14 'file':28,48,74 'flexibl':65 'format':30 'gitignor':51 'global':21 'ignor':73 'includ':43 'integr':49 'interfac':67 'issu':31 'javascript':89 'key':41 'like':87 'limit':81 'lint':16,39 'markdown':15,27 'markdownlint':88 'md':3,7 'modul':23 'npm':22 'offer':63 'open':2,6,12 'open-md-check':1,5 'open-sourc':11 'option':59,71 'package.json':54 'pattern':69 'recent':82 'remark':38 'remark-lint':37 'rule':34,47 'sourc':13 'stabl':78 'support':44 'tool':17,76 'updat':83 'usag':61 'use':32 'v1.2.3':24 'variabl':57 'via':53","created_at":"2026-05-01T13:47:55.441579+00:00","updated_at":"2026-05-01T13:47:55.441579+00:00","problems":[{"fix":"Export the correct path: export MD_LINT_CONFIG_PATH=./valid-config.json","cause":"The MD_LINT_CONFIG_PATH points to a non-existent or invalid file.","error":"Error: Config file not found"},{"fix":"Install the required lint rule: npm install remark-lint-final-newline","cause":"Custom rules require module installed; missing in node_modules or dependencies.","error":"Error: Cannot find module 'remark-lint-final-newline'"}],"ecosystem":"npm","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":"open-md-checker","cli_version":null,"type":"library","homepage":null,"github":null,"docs":null,"changelog":null,"pypi":null,"npm":"https://www.npmjs.com/package/open-md-checker","openapi_spec":null,"status_page":null,"smithery":null,"categories":["devops","testing"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-05-01","next_check":"2026-07-30","install_tag":null}}