{"id":51197661,"url":"https://github.com/jarvanstack/markdown-at-file-link","last_synced_at":"2026-06-27T22:02:04.282Z","repository":{"id":364051628,"uuid":"1266173917","full_name":"jarvanstack/markdown-at-file-link","owner":"jarvanstack","description":"Type @ in a Markdown file, search workspace files, and insert a clickable relative Markdown link.","archived":false,"fork":false,"pushed_at":"2026-06-11T11:49:53.000Z","size":44,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-06-11T13:24:52.693Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jarvanstack.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":"SUPPORT.md","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-11T11:37:58.000Z","updated_at":"2026-06-11T11:54:44.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/jarvanstack/markdown-at-file-link","commit_stats":null,"previous_names":["jarvanstack/markdown-at-file-link"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/jarvanstack/markdown-at-file-link","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jarvanstack%2Fmarkdown-at-file-link","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jarvanstack%2Fmarkdown-at-file-link/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jarvanstack%2Fmarkdown-at-file-link/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jarvanstack%2Fmarkdown-at-file-link/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jarvanstack","download_url":"https://codeload.github.com/jarvanstack/markdown-at-file-link/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jarvanstack%2Fmarkdown-at-file-link/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34869004,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-27T02:00:06.362Z","response_time":126,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":[],"created_at":"2026-06-27T22:02:03.744Z","updated_at":"2026-06-27T22:02:04.272Z","avatar_url":"https://github.com/jarvanstack.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Markdown File Link\n\nType `@` in a Markdown file, search workspace files, and insert a clickable relative Markdown link.\n\nThis extension is intentionally small: it only activates for Markdown files, has no runtime dependencies, and does not send any workspace data outside VS Code.\n\n[中文说明](README.zh-CN.md)\n\n## Features\n\n- `@` file completions in Markdown documents.\n- Fuzzy search by file name or workspace-relative path.\n- Inserts links relative to the current Markdown file.\n- Handles filenames with spaces by using Markdown angle-bracket link targets.\n- Command Palette fallback: `Markdown File Link: Insert Workspace File Link`.\n- Works in VS Code-compatible editors such as Cursor when installed in that editor's extension directory.\n\n## Usage\n\nOpen a Markdown file and type:\n\n```md\n@\n```\n\nContinue typing a file name or path, then select a suggestion.\n\nFor example, when editing `docs/demo.md`, selecting `server/main/main.go` inserts:\n\n```md\n[server/main/main.go](../server/main/main.go)\n```\n\nIf the completion list does not open automatically, run `Trigger Suggest`:\n\n- macOS: `Ctrl+Space` or the keybinding configured in your editor.\n- Windows/Linux: `Ctrl+Space`.\n\nYou can also run this command from the Command Palette:\n\n```text\nMarkdown File Link: Insert Workspace File Link\n```\n\n## Settings\n\n| Setting | Default | Description |\n| --- | --- | --- |\n| `markdownAtFileLink.maxFiles` | `20000` | Maximum workspace files to index. |\n| `markdownAtFileLink.maxSuggestions` | `200` | Maximum completion items shown after `@`. |\n| `markdownAtFileLink.exclude` | See `package.json` | Glob patterns excluded from the file index. |\n| `markdownAtFileLink.linkText` | `relativePath` | Link label style: `relativePath` or `fileName`. |\n| `markdownAtFileLink.insertStyle` | `markdownLink` | Insert style: `markdownLink` or `plainPath`. |\n\nExample:\n\n```json\n{\n  \"markdownAtFileLink.linkText\": \"fileName\",\n  \"markdownAtFileLink.maxSuggestions\": 100\n}\n```\n\n## Local Development\n\nInstall dependencies:\n\n```bash\nnpm install\n```\n\nRun a syntax check:\n\n```bash\nnpm run lint\n```\n\nOpen this repository in VS Code, press `F5`, and test the extension in the Extension Development Host.\n\nTo install the extension from source into local VS Code and Cursor extension directories:\n\n```bash\n./install.sh\n```\n\nThen run `Developer: Reload Window`.\n\n## Package\n\nCreate a `.vsix` package:\n\n```bash\nnpm run package\n```\n\n## Publish to Visual Studio Marketplace\n\nPublishing uses the official `@vscode/vsce` tool.\n\n1. Create or verify the Marketplace publisher named `jarvanstack`.\n2. Create a Personal Access Token with Marketplace publishing permission.\n3. Login:\n\n```bash\nnpx vsce login jarvanstack\n```\n\n4. Publish:\n\n```bash\nnpm run publish\n```\n\nIf `VSCE_PAT` is not configured, package locally and upload the generated `.vsix` from the Visual Studio Marketplace publisher page.\n\nOfficial docs:\n\n- https://code.visualstudio.com/api/working-with-extensions/publishing-extension\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjarvanstack%2Fmarkdown-at-file-link","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjarvanstack%2Fmarkdown-at-file-link","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjarvanstack%2Fmarkdown-at-file-link/lists"}