{"id":30313882,"url":"https://github.com/jezekon/hsk-character-map","last_synced_at":"2026-02-10T02:31:42.980Z","repository":{"id":308378346,"uuid":"1029167191","full_name":"jezekon/hsk-character-map","owner":"jezekon","description":"Chinese-English dictionary for Obsidian that visualizes HSK character relationships","archived":false,"fork":false,"pushed_at":"2025-10-28T20:42:21.000Z","size":1600,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-28T22:30:20.569Z","etag":null,"topics":["chinese","dictionary","graph-visualization","hsk-vocabulary","julia","obsidian","study-tool"],"latest_commit_sha":null,"homepage":"https://github.com/jezekon/hsk-character-map/releases","language":"Julia","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/jezekon.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-07-30T16:10:41.000Z","updated_at":"2025-09-06T15:25:42.000Z","dependencies_parsed_at":"2025-08-05T17:19:55.200Z","dependency_job_id":"97b24480-9cc7-49b9-a367-e69030bddcf8","html_url":"https://github.com/jezekon/hsk-character-map","commit_stats":null,"previous_names":["jezekon/hsk-character-map"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/jezekon/hsk-character-map","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jezekon%2Fhsk-character-map","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jezekon%2Fhsk-character-map/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jezekon%2Fhsk-character-map/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jezekon%2Fhsk-character-map/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jezekon","download_url":"https://codeload.github.com/jezekon/hsk-character-map/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jezekon%2Fhsk-character-map/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29289468,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-09T21:57:15.303Z","status":"online","status_checked_at":"2026-02-10T02:00:07.935Z","response_time":65,"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":["chinese","dictionary","graph-visualization","hsk-vocabulary","julia","obsidian","study-tool"],"created_at":"2025-08-17T18:52:38.094Z","updated_at":"2026-02-10T02:31:42.966Z","avatar_url":"https://github.com/jezekon.png","language":"Julia","funding_links":[],"categories":[],"sub_categories":[],"readme":"# HSK Character Map\n\nWhen learning Chinese, it's hard to remember which words share the same characters. You might know that 学 means \"study\", but it's not obvious that this same character appears in 学生 (student), 大学 (university), and 学习 (to study). Traditional dictionaries show you one word at a time. This tool shows you how characters connect across your entire HSK vocabulary, making it easier to spot patterns and learn related words together.\n\n**Features:**\n- HSK levels 1-7 support\n- Traditional and simplified characters\n- Visual connections using [Obsidian](https://obsidian.md/) graph view\n- Markdown files with translations, character breakdowns and cross-links\n\nThis tool creates an interactive dictionary for [Obsidian](https://obsidian.md/) that turns your HSK vocabulary into an interactive map. Open any word and see all the related words that share its characters. You learn connections, not just individual words.\n\n## Visual Example\n\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"doc/Obsidian_screenshot.png\" alt=\"HSK Character Map in Obsidian Graph View\" width=\"100%\"\u003e\n\u003c/div\u003e\n\n## How It Works\nTake the word **学习** (to study). It contains two characters that also appear in other words:\n- **学** appears in 学生 (student) and 大学 (university)  \n- **习** appears in 练习 (practice) and 习惯 (habit)\n\nThe tool finds these connections and creates clickable links between related words.\n## How to Use\n\n### Option 1: Download Pre-built Obsidian Vaults (Recommended)\n\n1. Go to the [Releases](../../releases) page\n2. Download the vault for your desired HSK level(s), for example:\n   - `HSK-1-4-Traditional.zip` / `HSK-1-4-Simplified.zip`\n3. Extract the zip file\n4. Open Obsidian → \"Open folder as vault\"\n5. Select the extracted directory\n6. Switch to Graph View to visualize character relationships\n\n### Option 2: Generate Custom Vault with Julia Script\n\nFor developers or those wanting specific HSK level combinations:\n\n1. **Prerequisites**: [Julia](https://julialang.org/) 1.11+ with JSON package\n2. **Data**: Ensure HSK JSON files are in `data/hsk_raw/` directory\n3. **Run**: Execute `julia --project=. main.jl` and follow the prompts to select:\n   - HSK levels (e.g., `1-4`, `1,3,5`, or `6`)\n   - Character type (traditional or simplified)\n4. **Open**: Use the generated `ObsidianVault` directory in Obsidian\n\n## Output Structure\n\nEach word generates a markdown file with:\n- HSK level tags (`#hsk1`, `#hsk2`, etc.)\n- English meanings\n- Character component links organized by:\n  - Individual Characters\n  - Two-Character Words  \n  - Three-Character Words\n  - Multi-Character Words\n\n**Example**: `大學生 (dà xué shēng), daxuesheng.md`\n```markdown\n#hsk1\nuniversity student\n\n### All meanings:\n- university student\n- college student\n\n\n## Character Components\n### Individual Characters:\n- [[大 (dà), da]] (big; large; great)\n- [[学 (xué), xue]] (to learn)\n- [[生 (shēng), sheng]] (to be born)\n### Two-Character Words:\n- [[大学 (Dà xué), daxue]] (the Great Learning, one of the Four Books 四书 in Confucianism)\n- [[学生 (xué sheng), xuesheng]] (student)\n```\n\n## Acknowledgments\n\n- Inspired by [Vietnamese Language Graph](https://github.com/DavidASix/vietnamese-language-graph) by DavidASix\n- HSK vocabulary data from [Complete HSK Vocabulary](https://github.com/drkameleon/complete-hsk-vocabulary)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjezekon%2Fhsk-character-map","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjezekon%2Fhsk-character-map","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjezekon%2Fhsk-character-map/lists"}