{"id":17311898,"url":"https://github.com/artempyanykh/marksman-vscode","last_synced_at":"2025-04-14T14:15:34.635Z","repository":{"id":37448276,"uuid":"345099989","full_name":"artempyanykh/marksman-vscode","owner":"artempyanykh","description":"Marksman extension for VSCode. Note taking with cross-references and diagnostics.","archived":false,"fork":false,"pushed_at":"2023-12-09T19:06:31.000Z","size":2242,"stargazers_count":45,"open_issues_count":4,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-04-14T14:15:27.977Z","etag":null,"topics":["autocompletion","language-server","lsp","markdown","note","vscode","vscode-extension"],"latest_commit_sha":null,"homepage":"https://github.com/artempyanykh/marksman","language":"TypeScript","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/artempyanykh.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":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-03-06T13:25:34.000Z","updated_at":"2025-03-13T03:50:31.000Z","dependencies_parsed_at":"2024-10-15T12:41:51.759Z","dependency_job_id":"2b586a34-b8c2-4c42-a140-e0bf58a4fd5b","html_url":"https://github.com/artempyanykh/marksman-vscode","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/artempyanykh%2Fmarksman-vscode","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/artempyanykh%2Fmarksman-vscode/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/artempyanykh%2Fmarksman-vscode/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/artempyanykh%2Fmarksman-vscode/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/artempyanykh","download_url":"https://codeload.github.com/artempyanykh/marksman-vscode/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248894943,"owners_count":21179153,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["autocompletion","language-server","lsp","markdown","note","vscode","vscode-extension"],"created_at":"2024-10-15T12:41:44.209Z","updated_at":"2025-04-14T14:15:34.605Z","avatar_url":"https://github.com/artempyanykh.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Marksman VSCode\n\nIntegrates [Marksman][mn] language server into VSCode for delightful Markdown\nnote taking experience.\n\nSee the [project page][mn] for more detailed information.\n\n## Screenshots\n\n- Hover preview:\n  ![Hover](./assets/readme/vsc-wiki-hover.png)\n- Completion:\n  \n  - Wiki link to another document:\n    ![Completion for wiki](./assets/readme/vsc-wiki-compl.png)\n\n  - Wiki link to a subsection of the current document:\n    ![Completion for wiki heading](./assets/readme/vsc-wiki-heading-compl.png)\n\n  - Reference link:\n    ![Completion for ref link](./assets/readme/vsc-ref-compl.png)\n- \"Show References\":\n  ![Show references](./assets/readme/vsc-find-references.png)\n- Project-wide diagnostics for broken wiki-links:\n  ![Diagnostics](./assets/readme/vsc-diag.png)\n\n## Installation\n\n1. **Get `marksman` server binary**.\n   The extension will try to automatically download Marksman language server\n   from GH releases. This is the easiest way to get started.\n\n   An alternative is to either download `marksman` binary from the [releases\n   page][mn-releases] or to build `marksman` from source. Put it somewhere in\n   your `PATH` and you should be good to go.\n2. **Add `.marksman.toml` to your workspace root folder**.\n   The extension is automatically activated only when `.marksman.toml` file is\n   present. This is done to avoid running Zeta Note on random Markdown files,\n   but rather only inside your notes folder.\n\n## Extension Settings\n\n- **Custom Command**: allows to specify a custom command to start\n  `marksman`. Mostly useful for development of `marksman` itself.\n- **Custom Command Dir**: allows to specify a CWD for the command above. For\n  development it's convenient to set the command to `dotnet run` and the command\n  dir to the dir where `marksman` sources are.\n\n## Development\n- **Set things up**: \n  - Run `npm install` to get the necessary packages.\n  - Run `npm watch` or hit F5 to do development/debugging.\n- **Package and release**:\n  - Install vsce via `npm install -g vsce`.\n  - Run `vsce package` to package the extension.\n  - Run `vsce publish` to publish the packaged archive.\n- **Local installation**:\n  - Run `code --install-extension [path-to-vsix]` to install the locally built extension.\n\n[roam]: https://roamresearch.com\n[md-memo]: https://github.com/svsool/vscode-memo\n[mn]: https://github.com/artempyanykh/marksman\n[mn-releases]: https://github.com/artempyanykh/marksman/releases","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fartempyanykh%2Fmarksman-vscode","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fartempyanykh%2Fmarksman-vscode","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fartempyanykh%2Fmarksman-vscode/lists"}