{"id":28818431,"url":"https://github.com/bulletmark/md-link-checker","last_synced_at":"2026-03-16T14:06:40.618Z","repository":{"id":299179860,"uuid":"1002296121","full_name":"bulletmark/md-link-checker","owner":"bulletmark","description":"Utility to check url, section reference, and path links in Markdown files","archived":false,"fork":false,"pushed_at":"2025-09-11T00:51:52.000Z","size":53,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-18T09:12:00.836Z","etag":null,"topics":["gfm","github","markdown"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bulletmark.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-15T06:35:36.000Z","updated_at":"2025-09-11T00:51:55.000Z","dependencies_parsed_at":"2025-06-15T06:49:48.792Z","dependency_job_id":"7985b1d5-74a5-4203-b9e8-7301138b52c2","html_url":"https://github.com/bulletmark/md-link-checker","commit_stats":null,"previous_names":["bulletmark/md-link-checker"],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/bulletmark/md-link-checker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bulletmark%2Fmd-link-checker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bulletmark%2Fmd-link-checker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bulletmark%2Fmd-link-checker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bulletmark%2Fmd-link-checker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bulletmark","download_url":"https://codeload.github.com/bulletmark/md-link-checker/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bulletmark%2Fmd-link-checker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30583906,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-16T09:53:36.164Z","status":"ssl_error","status_checked_at":"2026-03-16T09:53:29.590Z","response_time":96,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["gfm","github","markdown"],"created_at":"2025-06-18T19:05:17.491Z","updated_at":"2026-03-16T14:06:40.592Z","avatar_url":"https://github.com/bulletmark.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"## MD-LINK-CHECKER - Utility to check url, section reference, and path links in Markdown files\n[![PyPi](https://img.shields.io/pypi/v/md-link-checker)](https://pypi.org/project/md-link-checker/)\n\nThis is a simple command line utility to check url, section reference, and path\nlinks in Markdown files. It iterates through the specified Markdown files and\nchecks each link in the file for validity. If no file is specified then it\ndefaults to checking `README.md` in the current directory. URL network fetches\ncan be slow so they are checked simultaneously, doing a maximum 10 in parallel\n(by default but you can change that using the `-p/--parallel-url-checks`\noption). If you specify multiple files then all URLs across all files are\nextracted at the start so only unique URLs are checked and network fetches are\nminimised. There are a number of similar utilities available so why did I\ncreate another one? Well, all those that I tried didn't work!\n\nE.g. check links in the `README.md` file in the current directory:\n\n```\n$ cd /path/to/my/project\n$ md-link-checker\n```\n\nCheck links in all the `README.md` files across your projects:\n\n```\n$ cd ..\n$ md-link-checker */README.md\n```\n\nThe latest version and documentation is available at\nhttps://github.com/bulletmark/md-link-checker.\n\n## Installation or Upgrade\n\nPython 3.9 or later is required. You can run\n[`md-link-checker`][md-link-checker] most easily using [`uvx`][uvx]. Just make\nsure [`uv`][uv] is installed and then run the following command which will\ninstall `md-link-checker` from [PyPi][md-link-checker-py] \"on the fly\" and will\nthen run it immediately:\n\n```sh\n$ uvx md-link-checker [myfile.md]\n```\n\nOr install [`md-link-checker`][md-link-checker] formally on your system using\nusing [`uv tool`][uvtool] (or [`pipx`][pipx] or [`pipxu`][pipxu]). To install:\n\n```sh\n$ uv tool install md-link-checker\n```\n\nTo upgrade:\n\n```sh\n$ uv tool upgrade md-link-checker\n```\n\nTo uninstall:\n\n```sh\n$ uv tool uninstall md-link-checker\n```\n\n## Command Line Options\n\nType `md-link-checker -h` to view the usage summary:\n\n```\nusage: md-link-checker [-h] [-u] [-p PARALLEL_URL_CHECKS] [-v] [-f] [-w]\n                          [files ...]\n\nUtility to check url, section reference, and path links in Markdown files.\n\npositional arguments:\n  files                 one or more markdown files to check, default =\n                        \"README.md\"\n\noptions:\n  -h, --help            show this help message and exit\n  -u, --no-urls         do not check URL links, only check section and path\n                        links\n  -p, --parallel-url-checks PARALLEL_URL_CHECKS\n                        max number of URL checks to perform in parallel\n                        (default=10)\n  -v, --verbose         print links found in file as they are checked\n  -f, --no-fail         do not return final error code after failures\n  -w, --no-warnings     do not print warnings for ignored URLs\n```\n\n## License\n\nCopyright (C) 2025 Mark Blakeney. This program is distributed under the terms\nof the GNU General Public License. This program is free software: you can\nredistribute it and/or modify it under the terms of the GNU General Public\nLicense as published by the Free Software Foundation, either version 3 of the\nLicense, or any later version. This program is distributed in the hope that it\nwill be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of\nMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public\nLicense at \u003chttps://www.gnu.org/licenses/gpl-3.0.html\u003e for more details.\n\n[md-link-checker]: https://github.com/bulletmark/md-link-checker\n[md-link-checker-py]: https://pypi.org/project/md-link-checker\n[uv]: https://docs.astral.sh/uv/\n[uvtool]: https://docs.astral.sh/uv/guides/tools/#using-tools\n[uvx]: https://docs.astral.sh/uv/guides/tools/#using-tools\n[pipx]: https://github.com/pypa/pipx\n[pipxu]: https://github.com/bulletmark/pipxu\n\n\u003c!-- vim: se ai syn=markdown: --\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbulletmark%2Fmd-link-checker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbulletmark%2Fmd-link-checker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbulletmark%2Fmd-link-checker/lists"}