{"id":22967283,"url":"https://github.com/binarynoir/obsidian-markdown-tags","last_synced_at":"2025-08-28T23:32:59.769Z","repository":{"id":261886690,"uuid":"885629351","full_name":"binarynoir/obsidian-markdown-tags","owner":"binarynoir","description":"Enhance your Markdown documents with custom tags. Use predefined or custom labels, customizable colors, and arrow indicators to visually track tasks and statuses.","archived":false,"fork":false,"pushed_at":"2024-12-13T17:36:51.000Z","size":1119,"stargazers_count":16,"open_issues_count":2,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-08-17T18:30:56.145Z","etag":null,"topics":["markdown","obsidian","obsidian-md","obsidian-plugin","obsidianmd"],"latest_commit_sha":null,"homepage":"https://binarynoir.tech","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/binarynoir.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/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,"zenodo":null},"funding":{"buy_me_a_coffee":"binarynoir","ko_fi":"binarynoir"}},"created_at":"2024-11-09T01:25:13.000Z","updated_at":"2025-08-11T23:28:07.000Z","dependencies_parsed_at":"2024-11-24T03:17:40.995Z","dependency_job_id":"2a56de2b-6ef8-44bb-9642-ef03314914f5","html_url":"https://github.com/binarynoir/obsidian-markdown-tags","commit_stats":null,"previous_names":["binarynoir/obsidian-markdown-tags"],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/binarynoir/obsidian-markdown-tags","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/binarynoir%2Fobsidian-markdown-tags","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/binarynoir%2Fobsidian-markdown-tags/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/binarynoir%2Fobsidian-markdown-tags/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/binarynoir%2Fobsidian-markdown-tags/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/binarynoir","download_url":"https://codeload.github.com/binarynoir/obsidian-markdown-tags/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/binarynoir%2Fobsidian-markdown-tags/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":272578994,"owners_count":24959021,"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","status":"online","status_checked_at":"2025-08-28T02:00:10.768Z","response_time":74,"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":["markdown","obsidian","obsidian-md","obsidian-plugin","obsidianmd"],"created_at":"2024-12-14T21:12:29.493Z","updated_at":"2025-08-28T23:32:59.756Z","avatar_url":"https://github.com/binarynoir.png","language":"TypeScript","readme":"# Tags for Markdown: Enhanced Styled Labels for Obsidian\n\nAdd visual flair to your Markdown documents with custom tag styles! **Tags for Markdown** lets you highlight and style labels within Markdown documents using simple syntax, customizable colors, and optional arrow indicators—all within Obsidian. If you like **Tags for Markdown**, get our extension for [Visual Studio Code](https://github.com/binarynoir/vscode-markdown-tags/)!\n\n[![Support me on Buy Me a Coffee](https://img.shields.io/badge/Support%20me-Buy%20Me%20a%20Coffee-orange?style=for-the-badge\u0026logo=buy-me-a-coffee)](https://buymeacoffee.com/binarynoir)\n[![Support me on Ko-fi](https://img.shields.io/badge/Support%20me-Ko--fi-blue?style=for-the-badge\u0026logo=ko-fi)](https://ko-fi.com/binarynoir)\n[![Visit my website](https://img.shields.io/badge/Website-binarynoir.tech-8c8c8c?style=for-the-badge)](https://binarynoir.tech)\n\n![obsidian-markdown-tags](./screenshot.png)\n\n## Features\n\n### 🎨 Styled Tags\n\nHighlight and style tags with ease using predefined or custom styles.\n\n### 🖌️ Customizable Colors\n\nUse predefined colors or specify custom hex codes for both background and foreground colors, enabling unlimited styling options.\n\n### 📄 Flexible Syntax\n\n\nSimple, flexible syntax options:\n\nYou can use either the `|` (pipe) or `/` (slash) character as a separator between tag components:\n\n```markdown\n((tag|label))\n((tag/label))\n((tag|label|background-color))\n((tag/label/background-color))\n((tag|label|background-color|foreground-color))\n((tag/label/background-color/foreground-color))\n((\u003ctag|label)) \u003c!-- Adds an arrow to the left --\u003e\n((\u003ctag/label)) \u003c!-- Adds an arrow to the left --\u003e\n```\n\n\u003e **Note:** Both `|` and `/` are supported as separators. Use whichever you prefer or fits your workflow. This is especially useful when using tags within markdown tables.\n\n### 🌈 Supports a Variety of Colors\n\nChoose from predefined colors (`grey`, `green`, `orange`, etc.) or use custom hex codes to suit your design preferences.\n\n---\n\n## Getting Started\n\n1. **Install** the plugin from the Obsidian Community Plugins.\n2. **Enable** the plugin in the Obsidian settings.\n3. **Add Tags** in your Markdown files using the syntax below.\n\n### Basic Syntax Examples\n\n#### Status Tags\n\n```markdown\n((tag|todo)) ((tag|in-progress|#ffcc00)) ((tag|done|#28a745|#ffffff))\n```\n\n#### Arrowed Tags\n\n```markdown\n((\u003ctag|planned)) ((\u003ctag|custom test))\n```\n\n#### Customizing Colors\n\n```markdown\n((tag|background|#ff4500)) ((tag|foreground||#ff6347)) ((tag|both colors|#32cd32|#ffffff))\n```\n\n---\n\n## Tags and Colors\n\nAvailable supported tags: **todo**, **planned**, **in-progress**, **doing**, **done**, **tip**,\n**on-hold**, **tbd**, **proposed**, **draft**, **wip**, **mvp**,\n**blocked**, **canceled**, **error**, **warning**, **warn**\n\nFor each tag, the following colors are available: **grey**, **green**, **yellow**, **orange**, **blue**, **purple**, **red**.\n\nSee Examples Markdown Documents\n\n### Tag Examples\n\n#### TODO\n\n- `((tag|todo|grey))`\n- `((tag|todo|green))`\n- `((tag|todo|yellow))`\n- `((tag|todo|orange))`\n- `((tag|todo|blue))`\n- `((tag|todo|purple))`\n- `((tag|todo|red))`\n\n#### PLANNED\n\n- `((tag|planned|grey))`\n- `((tag|planned|green))`\n- `((tag|planned|yellow))`\n- `((tag|planned|orange))`\n- `((tag|planned|blue))`\n- `((tag|planned|purple))`\n- `((tag|planned|red))`\n\n#### IN-PROGRESS\n\n- `((tag|in-progress|grey))`\n- `((tag|in-progress|green))`\n- `((tag|in-progress|yellow))`\n- `((tag|in-progress|orange))`\n- `((tag|in-progress|blue))`\n- `((tag|in-progress|purple))`\n- `((tag|in-progress|red))`\n\n#### DOING\n\n- `((tag|doing|grey))`\n- `((tag|doing|green))`\n- `((tag|doing|yellow))`\n- `((tag|doing|orange))`\n- `((tag|doing|blue))`\n- `((tag|doing|purple))`\n- `((tag|doing|red))`\n\n#### DONE\n\n- `((tag|done|grey))`\n- `((tag|done|green))`\n- `((tag|done|yellow))`\n- `((tag|done|orange))`\n- `((tag|done|blue))`\n- `((tag|done|purple))`\n- `((tag|done|red))`\n\n#### TIP\n\n- `((tag|tip|grey))`\n- `((tag|tip|green))`\n- `((tag|tip|yellow))`\n- `((tag|tip|orange))`\n- `((tag|tip|blue))`\n- `((tag|tip|purple))`\n- `((tag|tip|red))`\n\n... _(repeat as necessary for remaining tags: on-hold, tbd, proposed, draft, mvp, etc.)_\n\n---\n\n### With Arrow (using `((\u003ctag|label|bgcolor))`)\n\n#### MVP\n\n- `((\u003ctag|mvp|grey))`\n- `((\u003ctag|mvp|green))`\n- `((\u003ctag|mvp|yellow))`\n- `((\u003ctag|mvp|orange))`\n- `((\u003ctag|mvp|blue))`\n- `((\u003ctag|mvp|purple))`\n- `((\u003ctag|mvp|red))`\n\n... _(repeat as necessary for remaining tags: on-hold, tbd, proposed, draft, mvp, etc.)_\n\n---\n\n## Advanced Options\n\n### CSS Integration\n\nAdd custom styles by modifying the `style.css` file in the plugin folder to match your preferences.\n\n### Error Handling\n\nThe plugin defaults to `grey` when invalid colors are detected to ensure a consistent and polished look.\n\n---\n\n## How to install the plugin\n\n- Download the [Latest release](https://github.com/binarynoir/obsidian-markdown-tags/releases/latest)\n- Extract the `obsidian-markdown-tags` folder from the zip to your vault `\u003cvault\u003e/.obsidian/plugins/`\n\n### Manually installing the plugin\n\nCopy over main.js, styles.css, manifest.json to your vault VaultFolder/.obsidian/plugins/obsidian-markdown-tags/.\n\n---\n\n## Contributing\n\n\u003e Feel free to submit issues, feature requests, or contribute code on GitHub.\n\n### Development\n\n```bash\nnpm install\nnpm run build\ncp main.js manifest.json /path/to/your/vault/.obsidian/plugins/obsidian-markdown-tags\n```\n\n### Release\n\n### Releasing new releases\n\n- Update the changelog with new features and fixes\n- Commit all changed files and create a pull request\n- Update the `manifest.json` with the new version number, such as `1.0.1`, and the minimum Obsidian version required for your latest release.\n- Update the `versions.json` file with `\"new-plugin-version\": \"minimum-obsidian-version\"` so older versions of Obsidian can download an older version of your plugin that's compatible.\n- Create new GitHub release using the new version number as the \"Tag version\". Use the exact version number, don't include a prefix `v`. See here for an example: https://github.com/obsidianmd/obsidian-sample-plugin/releases\n- Upload the files `manifest.json`, `main.js`, `styles.css` as binary attachments. Note: The manifest.json file must be in two places, first the root path of your repository and also in the release.\n- Publish the release.\n\n\u003e You can simplify the version bump process by running `npm version patch`, `npm version minor` or `npm version major` after updating `minAppVersion` manually in `manifest.json`.\n\u003e The command will bump version in `manifest.json` and `package.json`, and add the entry for the new version to `versions.json`\n\n```bash\ngit checkout main\ngit pull\ngit tag -a x.y.z -m \"x.y.z\"\ngit push --tags\n```\n\nThe release will automatically be drafted.\n\n## License\n\nMIT License\n\n---\n\n## Support\n\nIf you encounter any issues or have questions, please open an issue on GitHub.\n\n## Author\n\nJohn Smith III\n\n## Acknowledgments\n\nThanks to all contributors and users for their support and feedback.\n","funding_links":["https://buymeacoffee.com/binarynoir","https://ko-fi.com/binarynoir"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbinarynoir%2Fobsidian-markdown-tags","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbinarynoir%2Fobsidian-markdown-tags","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbinarynoir%2Fobsidian-markdown-tags/lists"}