{"id":39655485,"url":"https://github.com/expressive-code/annotation-comments","last_synced_at":"2026-01-18T09:17:07.532Z","repository":{"id":257797950,"uuid":"838558756","full_name":"expressive-code/annotation-comments","owner":"expressive-code","description":null,"archived":false,"fork":false,"pushed_at":"2025-02-15T11:16:39.000Z","size":245,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-19T19:25:57.304Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/expressive-code.png","metadata":{"files":{"readme":"README.md","changelog":null,"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":"2024-08-05T22:33:46.000Z","updated_at":"2025-02-15T11:15:19.000Z","dependencies_parsed_at":"2024-09-25T07:39:06.134Z","dependency_job_id":"4f677f68-ef3a-457e-803c-0b7667ef2136","html_url":"https://github.com/expressive-code/annotation-comments","commit_stats":null,"previous_names":["expressive-code/annotation-comments"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/expressive-code/annotation-comments","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/expressive-code%2Fannotation-comments","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/expressive-code%2Fannotation-comments/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/expressive-code%2Fannotation-comments/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/expressive-code%2Fannotation-comments/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/expressive-code","download_url":"https://codeload.github.com/expressive-code/annotation-comments/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/expressive-code%2Fannotation-comments/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28534156,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-18T00:39:45.795Z","status":"online","status_checked_at":"2026-01-18T02:00:07.578Z","response_time":98,"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-01-18T09:17:07.395Z","updated_at":"2026-01-18T09:17:07.516Z","avatar_url":"https://github.com/expressive-code.png","language":"TypeScript","readme":"# annotation-comments\n\nThis library provides functionality to parse and extract annotation comments from code snippets.\n\nAnnotation comments allow authors to annotate pieces of source code with additional information (e.g. marking important lines, highlighting changes, adding notes, and more) while keeping it readable and functional:\n\n````mdx ignore-tags\n```js\n// [!note] The note explains the `console.log(...)` line\nconsole.log('Some code');\n// The next line will be marked as inserted\nnewCode(); // [!ins]\n```\n````\n\nWhile this library was originally developed for the documentation tool [Expressive Code](https://expressive-code.com), the annotation comment syntax is designed to be compatible with Shiki's common transformer syntax and extend its functionality. It was intentionally decoupled from Expressive Code to allow other tools to use it as well.\n\n## When should I use this?\n\nUsing this package directly is only recommended if you are building a custom documentation tool or want to integrate annotation comments into your own workflow.\n\nIf you are looking for a ready-to-use solution that uses this package to support annotation comments in code snippets, check out [Expressive Code](https://expressive-code.com) instead.\n\n## Installation, Usage \u0026 API\n\nFor installation instructions, usage examples, and the full API documentation of the main library package, please refer to the [package's README](packages/annotation-comments/README.md).\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fexpressive-code%2Fannotation-comments","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fexpressive-code%2Fannotation-comments","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fexpressive-code%2Fannotation-comments/lists"}