{"id":50812385,"url":"https://github.com/viggomeesters/obsidian-yaml-viewer","last_synced_at":"2026-06-13T06:06:00.911Z","repository":{"id":362863549,"uuid":"1261058022","full_name":"viggomeesters/obsidian-yaml-viewer","owner":"viggomeesters","description":"Read-only YAML tree viewer for Obsidian","archived":false,"fork":false,"pushed_at":"2026-06-06T08:18:46.000Z","size":766,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-06T10:09:23.260Z","etag":null,"topics":["obsidian","obsidian-plugin","typescript","yaml","yml"],"latest_commit_sha":null,"homepage":"https://github.com/viggomeesters/obsidian-yaml-viewer#readme","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/viggomeesters.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"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-06T07:22:52.000Z","updated_at":"2026-06-06T08:18:37.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/viggomeesters/obsidian-yaml-viewer","commit_stats":null,"previous_names":["viggomeesters/obsidian-yaml-viewer"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/viggomeesters/obsidian-yaml-viewer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/viggomeesters%2Fobsidian-yaml-viewer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/viggomeesters%2Fobsidian-yaml-viewer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/viggomeesters%2Fobsidian-yaml-viewer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/viggomeesters%2Fobsidian-yaml-viewer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/viggomeesters","download_url":"https://codeload.github.com/viggomeesters/obsidian-yaml-viewer/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/viggomeesters%2Fobsidian-yaml-viewer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34273822,"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-13T02:00:06.617Z","response_time":62,"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":["obsidian","obsidian-plugin","typescript","yaml","yml"],"created_at":"2026-06-13T06:06:00.116Z","updated_at":"2026-06-13T06:06:00.879Z","avatar_url":"https://github.com/viggomeesters.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/hero.svg\" alt=\"YAML Viewer for Obsidian\" width=\"100%\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/viggomeesters/obsidian-yaml-viewer/releases/latest\"\u003e\u003cimg alt=\"Latest release\" src=\"https://img.shields.io/github/v/release/viggomeesters/obsidian-yaml-viewer?style=flat-square\"\u003e\u003c/a\u003e\n  \u003ca href=\"LICENSE\"\u003e\u003cimg alt=\"MIT license\" src=\"https://img.shields.io/badge/license-MIT-green?style=flat-square\"\u003e\u003c/a\u003e\n  \u003cimg alt=\"Obsidian 1.5.0+\" src=\"https://img.shields.io/badge/Obsidian-1.5.0%2B-7c3aed?style=flat-square\"\u003e\n  \u003cimg alt=\"Read-only\" src=\"https://img.shields.io/badge/mode-read--only-0f766e?style=flat-square\"\u003e\n\u003c/p\u003e\n\n# YAML Viewer\n\nYAML Viewer is a read-only Obsidian plugin for browsing `.yaml` and `.yml` files as a structured tree. It is built for schema files, configuration files, data contracts, and other YAML documents where comments and formatting matter.\n\n![YAML Viewer preview](assets/screenshot.svg)\n\n## Features\n\n- Opens `.yaml` and `.yml` files in a dedicated Obsidian view.\n- Shows maps, sequences, scalars, aliases, document comments, node comments, and parse errors.\n- Filters the tree by key, value, or YAML path.\n- Provides a right-side outline for fast navigation through large YAML files.\n- Includes expand/collapse controls, copy raw YAML, and copy-path buttons.\n- Shows raw YAML with lightweight syntax highlighting and line numbers.\n- Stays read-only by design: it never writes back to your YAML files.\n\n## Privacy and clipboard behavior\n\nYAML Viewer does not make network requests and does not send vault content to external services. It writes to the system clipboard only when you explicitly click a copy button, such as copying raw YAML or a YAML path. It does not read clipboard contents.\n\n## Why read-only?\n\nYAML files often contain comments, anchors, ordering, and formatting that matter. A form editor can easily reserialize YAML and damage those details. YAML Viewer intentionally does not write to disk, so it cannot reformat or corrupt source-of-truth configuration files.\n\n## Installation\n\n### Community plugin directory\n\nYAML Viewer is ready for submission to the Obsidian Community plugin directory. Once accepted, it can be installed from **Settings -\u003e Community plugins -\u003e Browse** inside Obsidian.\n\n### Manual installation\n\nUntil the community directory submission is accepted:\n\n1. Download `main.js`, `manifest.json`, and `styles.css` from the [latest release](https://github.com/viggomeesters/obsidian-yaml-viewer/releases/latest).\n2. Create this folder in your vault: `.obsidian/plugins/yaml-viewer/`.\n3. Put the downloaded files in that folder.\n4. Reload Obsidian.\n5. Enable **YAML Viewer** in **Settings -\u003e Community plugins**.\n\n### BRAT installation\n\nFor beta testing, install the plugin with [BRAT](https://github.com/TfTHacker/obsidian42-brat) using this repository URL:\n\n```text\nhttps://github.com/viggomeesters/obsidian-yaml-viewer\n```\n\n## Usage\n\nOpen any `.yaml` or `.yml` file in your vault. Obsidian will open it with YAML Viewer.\n\nUse the toolbar to:\n\n- filter visible nodes\n- expand or collapse the tree\n- copy the raw YAML source\n- copy individual YAML paths from tree rows\n\nUse the outline panel to jump through large files quickly.\n\n## Development\n\n```bash\nnpm install\nnpm run build\nnpx tsc --noEmit\n```\n\nFor local development, copy or symlink this repository into `.obsidian/plugins/yaml-viewer/` inside an Obsidian vault.\n\n## Release process\n\nObsidian installs community plugin files from GitHub releases. For each release:\n\n1. Update `manifest.json`, `package.json`, and `versions.json`.\n2. Run `npm install`, `npm run build`, and `npx tsc --noEmit`.\n3. Create a GitHub release whose tag exactly matches `manifest.json.version`.\n4. Attach `main.js`, `manifest.json`, and `styles.css` as release assets.\n\nThe release workflow in `.github/workflows/release.yml` can publish those assets after the version has been updated and committed.\n\n## Community directory submission\n\nThe repository is prepared for Obsidian Community plugin submission. The remaining submission step must be completed by the repository owner in the Obsidian Community site because it requires signing in, linking GitHub, and confirming the developer policies/support commitment.\n\nSubmit this repository URL:\n\n```text\nhttps://github.com/viggomeesters/obsidian-yaml-viewer\n```\n\nSteps:\n\n1. Sign in to [community.obsidian.md](https://community.obsidian.md).\n2. Link the GitHub account that owns this repository.\n3. Open **Plugins -\u003e New plugin**.\n4. Enter the repository URL above.\n5. Confirm the developer policies and submit.\n6. Address any automated review feedback.\n\nThe current release is ready for review:\n\n- root `README.md`, `LICENSE`, and `manifest.json` exist\n- `manifest.json.version` is `0.1.2`\n- GitHub release `0.1.2` exists\n- release assets include `main.js`, `manifest.json`, and `styles.css`\n- release assets have GitHub artifact attestations\n- `versions.json` maps supported Obsidian versions\n\nOfficial references:\n\n- [Submit your plugin](https://docs.obsidian.md/Plugins/Releasing/Submit%20your%20plugin)\n- [Obsidian releases repository](https://github.com/obsidianmd/obsidian-releases)\n\n## License\n\n[MIT](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fviggomeesters%2Fobsidian-yaml-viewer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fviggomeesters%2Fobsidian-yaml-viewer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fviggomeesters%2Fobsidian-yaml-viewer/lists"}