{"id":30351052,"url":"https://github.com/opensource-brainband/vizard","last_synced_at":"2025-08-21T01:03:42.325Z","repository":{"id":310355046,"uuid":"1037827168","full_name":"opensource-Brainband/vizard","owner":"opensource-Brainband","description":"CSV-like Markdown extensions for rendering charts and lightweight data visualizations","archived":false,"fork":false,"pushed_at":"2025-08-17T15:06:46.000Z","size":185,"stargazers_count":3,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-17T16:04:46.251Z","etag":null,"topics":["chart","csv","d3","data-visualization","dsl","extension","graph","markdown","markdown-it","open-source","readme","table","typescript","visualization","vscode-extension"],"latest_commit_sha":null,"homepage":"https://opensource-brainband.github.io/vizard/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/opensource-Brainband.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2025-08-14T07:20:40.000Z","updated_at":"2025-08-17T14:58:05.000Z","dependencies_parsed_at":"2025-08-17T16:04:53.808Z","dependency_job_id":"757939aa-e3eb-4f18-874a-9a4d03d69249","html_url":"https://github.com/opensource-Brainband/vizard","commit_stats":null,"previous_names":["opensource-brainband/vizard"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/opensource-Brainband/vizard","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opensource-Brainband%2Fvizard","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opensource-Brainband%2Fvizard/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opensource-Brainband%2Fvizard/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opensource-Brainband%2Fvizard/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/opensource-Brainband","download_url":"https://codeload.github.com/opensource-Brainband/vizard/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opensource-Brainband%2Fvizard/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271073391,"owners_count":24694538,"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-18T02:00:08.743Z","response_time":89,"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":["chart","csv","d3","data-visualization","dsl","extension","graph","markdown","markdown-it","open-source","readme","table","typescript","visualization","vscode-extension"],"created_at":"2025-08-18T23:00:50.021Z","updated_at":"2025-08-18T23:02:37.974Z","avatar_url":"https://github.com/opensource-Brainband.png","language":"TypeScript","readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"apps/web/src/assets/logo.svg\" alt=\"vizard logo\" width=\"250\" /\u003e\n  \u003ch1\u003evizard\u003c/h1\u003e\n  \u003cp\u003e🪄 Open Source Markdown-based Data Visualization Tool\u003c/p\u003e\n  \u003cp\u003e\n    \u003ca href=\"https://opensource-brainband.github.io/vizard/\"\u003e\u003cimg alt=\"Homepage\" src=\"https://img.shields.io/badge/Homepage-vizard-blue?style=flat-square\"\u003e\u003c/a\u003e\n    \u003ca href=\"LICENSE\"\u003e\u003cimg alt=\"License: MIT\" src=\"https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square\"\u003e\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n\n\n\n## 📖 About\n\n**vizard** is an open source tool that allows you to easily visualize charts and tables from CSV/DSL data within markdown documents.  \nJust enter your data in a code block and it will be automatically rendered as bar charts, line charts, tables, and more.\n\n\n\n\n\n\n## ✨ Features\n\n- **Automatic CSV/DSL Chart Rendering**\n- **Live Preview**\n- **Easy Extensibility**\n- **Quick Start**\n\n\n\n\n\n\n## 📁 Project Structure\n\n```\nvizard/\n├── apps/\n│   ├── md-renderer/      # Markdown-based renderer app\n│   └── web/              # Web frontend app\n├── packages/\n│   └── src/\n│       ├── render/       # Chart/table rendering functions\n│       ├── parseCSV.ts   # CSV parser\n│       └── markdown.ts   # Markdown utilities\n└── README.md\n```\n\n- **apps/md-renderer/**: Markdown preview and chart rendering app\n- **apps/web/**: Web frontend app\n- **packages/src/render/**: Rendering functions for bar chart, line chart, table, etc.\n- **packages/src/parseCSV.ts**: CSV code block parsing function\n- **docs/**: Sample markdown and data\n\n\n\n\n\n\n## 🚀 Getting Started\n\n### 1. Installation\n\n```bash\ngit clone https://github.com/opensource-Brainband/vizard.git\ncd vizard\nnpm install\n```\n\n### 2. Run\n\n#### For the web app:\n```bash\ncd apps/web\nnpm run dev\n```\n\n#### For the markdown renderer app:\n```bash\ncd apps/md-renderer\nnpm run dev\n```\n\nOpen your browser and go to http://localhost:5173\n\n\n\n\n\n\n\n## 📝 Chart Block Syntax\n\nYou can render charts and tables by writing a CSV code block in your markdown.  \nThe first line (info string) can include options like `title` and `type`.\n\n**Syntax:**\n\u003cpre\u003e\n```csv title=\"Chart Title\" type=\"bar\"\nHeader1,Header2\nvalue1,value2\n...\n```\n\u003c/pre\u003e\n\n\n\n**Options:**\n- `title` (optional): The chart or table title.\n- `type` (required): The visualization type.  \n  - `bar` : Bar chart  \n  - `line` : Line chart  \n  - `table` : Table\n\n\n\n\n\n## 🛠️ Usage\n\nSimply enter a CSV code block in the markdown editor and the chart will be rendered automatically.\n\n\n\n\n**CSV Chart Example:**\n\u003cpre\u003e\n```csv title=\"Sales Data\" type=\"bar\"\n# Only rendered as a chart in vizard, not on GitHub\nDate,Sales\n2021-01-01,100\n2021-01-02,150\n2021-01-03,120\n```\n\u003c/pre\u003e\n\n\n\n\n\n\n\n## 🖼 Example\n\n\u003cimg width=\"930\" height=\"428\" alt=\"Image\" src=\"https://github.com/user-attachments/assets/7d73fe31-8728-4181-829e-1521c30d0fd0\" /\u003e\n\n\n\n\n\n\n## 🤝 Contributing\n\n1. Fork this repository.\n2. Create a new branch: `git checkout -b feature/your-feature`\n3. Commit your changes: `git commit -m 'Add some feature'`\n4. Push to the branch: `git push origin feature/your-feature`\n5. Create a Pull Request.\n\n\n\n\n\n\n\n\u003cdiv align=\"center\"\u003e\n  \u003csub\u003eMade with ❤️ by \u003ca href=\"https://github.com/opensource-Brainband/vizard\"\u003evizard contributors\u003c/a\u003e\u003c/sub\u003e\n\u003c/div\u003e\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopensource-brainband%2Fvizard","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopensource-brainband%2Fvizard","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopensource-brainband%2Fvizard/lists"}