{"id":18348659,"url":"https://github.com/averagehelper/meta-comments","last_synced_at":"2025-07-07T18:36:06.269Z","repository":{"id":113951363,"uuid":"523925661","full_name":"AverageHelper/meta-comments","owner":"AverageHelper","description":"A VS Code extension for highlighting MARK comments, a la Xcode. (Read-only Git mirror)","archived":false,"fork":false,"pushed_at":"2023-12-14T17:47:31.000Z","size":1541,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-02-15T14:53:55.575Z","etag":null,"topics":["mirror"],"latest_commit_sha":null,"homepage":"https://git.average.name/AverageHelper/meta-comments","language":"TypeScript","has_issues":false,"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/AverageHelper.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":"FUNDING.yml","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},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":"https://average.name/support"}},"created_at":"2022-08-12T02:02:18.000Z","updated_at":"2023-12-14T17:36:56.000Z","dependencies_parsed_at":"2024-12-23T19:33:11.435Z","dependency_job_id":null,"html_url":"https://github.com/AverageHelper/meta-comments","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AverageHelper%2Fmeta-comments","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AverageHelper%2Fmeta-comments/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AverageHelper%2Fmeta-comments/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AverageHelper%2Fmeta-comments/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AverageHelper","download_url":"https://codeload.github.com/AverageHelper/meta-comments/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248128664,"owners_count":21052441,"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":["mirror"],"created_at":"2024-11-05T21:18:44.802Z","updated_at":"2025-04-09T23:28:42.903Z","avatar_url":"https://github.com/AverageHelper.png","language":"TypeScript","funding_links":["https://average.name/support"],"categories":[],"sub_categories":[],"readme":"# meta-comments\n\nXcode has this really neat organizational feature for some languages where specially-formatted comments will decorate the editor with dividers and bold formatting. This extension brings some of that functionality to VS Code.\n\n### Alternative Projects\n\nMy work here is largely based on that of these projects below.\n\n[everdrone/mark-meta-comments](https://github.com/everdrone/mark-meta-comments) - Major design and implementation inspiration for this plugin.\n\n[snak1t/vscode-marks-to-outline](https://github.com/snak1t/vscode-marks-to-outline) - Highlights MARK comments and adds them to the outline. Has their own style, but more configurable at the moment.\n\n## Features\n\n![Marked headings, divided markings, and block markings](/images/demo.gif)\n\nThese comments can make clear to readers on _any_ IDE that something is going on. With this extension, VS Code will parse these comments and create visual editor decorations.\n\nPlain marks are a soft visual content divider:\n\n```ts\n// MARK: Some Text\n```\n\n![Marked Headings](/images/mark-plain.png)\n\nDivided marks get an overline, and their (optional) text appears in the Outline view:\n\n```ts\n// MARK: - Optional Text\n```\n\n![Divided Marked Headings and entry in the Outline view](/images/mark-divider.png)\n\nMarked blocks color the editor background between them. Their text also appears in the Outline panel:\n\n```ts\n// MARK: --- Optional Text\n\n\t(...)\n\n// MARK: ---\n```\n\n![Marked Block and entry in the Outline view](/images/mark-block.png)\n\n## Extension Settings\n\nThis extension contributes the following settings:\n\n- `meta-comments.blockColor`: The background color to use between heavy block (`---`) marks.\n- `meta-comments.lineLimit`: The maximum number of lines in a file before we consider searching it for mark comments.\n- `meta-comments.shouldBoldCommentStart`: Set to `true` to bold the comment start (the `//` part) along with the rest of the line.\n\n## Release Notes\n\nSee [CHANGELOG.md](/CHANGELOG.md).\n\n## Known Issues\n\nPRs are welcome and appreciated to help solve the following or any other issues you may have:\n\n- Highlighted blocks (using `MARK: ---`) have a visible underline.\n- Decorate the code minimap. There's an open issue at [microsoft/vscode#74843](https://github.com/microsoft/vscode/issues/74843).\n\n## Contributing\n\nThis project lives primarily at [git.average.name](https://git.average.name/AverageHelper/meta-comments). Read-only mirrors also exist on [Codeberg](https://codeberg.org/AverageHelper/meta-comments) and [GitHub](https://github.com/AverageHelper/meta-comments). Issues or pull requests should be filed at [git.average.name](https://git.average.name/AverageHelper/meta-comments). You may sign in or create an account directly, or use one of several OAuth 2.0 providers.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faveragehelper%2Fmeta-comments","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faveragehelper%2Fmeta-comments","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faveragehelper%2Fmeta-comments/lists"}