{"action":"created","issue":{"url":"https://api.github.com/repos/wooorm/mdast-lint/issues/17","labels_url":"https://api.github.com/repos/wooorm/mdast-lint/issues/17/labels{/name}","comments_url":"https://api.github.com/repos/wooorm/mdast-lint/issues/17/comments","events_url":"https://api.github.com/repos/wooorm/mdast-lint/issues/17/events","html_url":"https://github.com/wooorm/mdast-lint/issues/17","id":90471651,"number":17,"title":"Add a rule to detect broken internal links","user":{"login":"cirosantilli","id":1429315,"avatar_url":"https://avatars.githubusercontent.com/u/1429315?v=3","gravatar_id":"","url":"https://api.github.com/users/cirosantilli","html_url":"https://github.com/cirosantilli","followers_url":"https://api.github.com/users/cirosantilli/followers","following_url":"https://api.github.com/users/cirosantilli/following{/other_user}","gists_url":"https://api.github.com/users/cirosantilli/gists{/gist_id}","starred_url":"https://api.github.com/users/cirosantilli/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/cirosantilli/subscriptions","organizations_url":"https://api.github.com/users/cirosantilli/orgs","repos_url":"https://api.github.com/users/cirosantilli/repos","events_url":"https://api.github.com/users/cirosantilli/events{/privacy}","received_events_url":"https://api.github.com/users/cirosantilli/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":3,"created_at":"2015-06-23T19:32:04Z","updated_at":"2015-06-28T19:18:24Z","closed_at":null,"body":"By internal links I mean:\r\n\r\n- `[see this file](another/file.md)`\r\n- `[see this header](#some-header)`\r\n\r\nI often avoid writing those because I know they will break sooner or later, but I would really like to use internal links.\r\n\r\nIf only I had a tool that notified me when either of those broke, that would be awesome ... :-)\r\n\r\nHeader links are a bit harder since they require you to specify the ID generation rule which is not standardized... but we could just start by copying GitHub's which works well for common headers of most implementations. See: https://github.com/cirosantilli/test/blob/master/md.md#012-uppercase-underline_hyphen-spaces--othersend\r\n\r\nOn markdownlint: https://github.com/mivok/markdownlint/issues/95"},"comment":{"url":"https://api.github.com/repos/wooorm/mdast-lint/issues/comments/116318470","html_url":"https://github.com/wooorm/mdast-lint/issues/17#issuecomment-116318470","issue_url":"https://api.github.com/repos/wooorm/mdast-lint/issues/17","id":116318470,"user":{"login":"cirosantilli","id":1429315,"avatar_url":"https://avatars.githubusercontent.com/u/1429315?v=3","gravatar_id":"","url":"https://api.github.com/users/cirosantilli","html_url":"https://github.com/cirosantilli","followers_url":"https://api.github.com/users/cirosantilli/followers","following_url":"https://api.github.com/users/cirosantilli/following{/other_user}","gists_url":"https://api.github.com/users/cirosantilli/gists{/gist_id}","starred_url":"https://api.github.com/users/cirosantilli/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/cirosantilli/subscriptions","organizations_url":"https://api.github.com/users/cirosantilli/orgs","repos_url":"https://api.github.com/users/cirosantilli/repos","events_url":"https://api.github.com/users/cirosantilli/events{/privacy}","received_events_url":"https://api.github.com/users/cirosantilli/received_events","type":"User","site_admin":false},"created_at":"2015-06-28T19:18:24Z","updated_at":"2015-06-28T19:18:24Z","body":"- `#readme`: hard choice. I think it should warn as it is too GH specific, and people should use a top level header and link to it anyway, which works for all markdown files, not just readmes\r\n- different algorithms: yup, that is a pain point. The only real solution is to encode them all, and chose on the config file which one you want to enforce :-(\r\n- externalizing: sounds like a good solution\r\n- I don't understand how that relates to this feature, maybe because I don't fully understand `mdast-github`. Do you mean a tool that you add special markup like [](link_to \"My header\")`, and it then parses that into `#my-header` for github or any other style you choose? While it is the only solution for portability before standardization, pre processing is really painful :-("}}