{"action":"opened","issue":{"url":"https://api.github.com/repos/jsdoc3/jsdoc/issues/1069","labels_url":"https://api.github.com/repos/jsdoc3/jsdoc/issues/1069/labels{/name}","comments_url":"https://api.github.com/repos/jsdoc3/jsdoc/issues/1069/comments","events_url":"https://api.github.com/repos/jsdoc3/jsdoc/issues/1069/events","html_url":"https://github.com/jsdoc3/jsdoc/issues/1069","id":107390276,"number":1069,"title":"Reusing @link","user":{"login":"vitaly-t","id":5108906,"avatar_url":"https://avatars.githubusercontent.com/u/5108906?v=3","gravatar_id":"","url":"https://api.github.com/users/vitaly-t","html_url":"https://github.com/vitaly-t","followers_url":"https://api.github.com/users/vitaly-t/followers","following_url":"https://api.github.com/users/vitaly-t/following{/other_user}","gists_url":"https://api.github.com/users/vitaly-t/gists{/gist_id}","starred_url":"https://api.github.com/users/vitaly-t/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/vitaly-t/subscriptions","organizations_url":"https://api.github.com/users/vitaly-t/orgs","repos_url":"https://api.github.com/users/vitaly-t/repos","events_url":"https://api.github.com/users/vitaly-t/events{/privacy}","received_events_url":"https://api.github.com/users/vitaly-t/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":0,"created_at":"2015-09-20T12:16:25Z","updated_at":"2015-09-20T12:16:25Z","closed_at":null,"body":"Can't seem to find how to reuse links.\r\n\r\nI am using MD notation everywhere, and have:\r\n```javascript\r\n  \"plugins\": [\r\n    \"plugins/markdown\"\r\n  ]\r\n```\r\n\r\nThis doesn't seem to work for `@link` however. I can only find examples of the in-line use of URL-s. \r\n\r\nThat's not really usable, because not only I reuse links in documentation a lot, but the number of links is such, if I start using in-line links everywhere, the code documentation will look unreadable in its raw text format, which is a huge no-no. Plus, links become much harder to update.\r\n\r\nAm I missing something or is this feature missing in the library? I would find the latter hard to believe, because it is the most essential from the MD syntax, to be able to predefine links and refer to them via `[link name]`.\r\n\r\n\r\n"}}