{"id":31786036,"url":"https://github.com/adam-elmi/sommark","last_synced_at":"2026-04-01T23:56:32.822Z","repository":{"id":317871904,"uuid":"1068738810","full_name":"Adam-Elmi/SomMark","owner":"Adam-Elmi","description":"SomMark is a simple and extensible markup language designed for writing documentation and structured content. ","archived":false,"fork":false,"pushed_at":"2026-02-17T20:29:40.000Z","size":2932,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-02-18T01:26:53.022Z","etag":null,"topics":["docs","documentation","dsl","html","json","json-langugae","langauge","mapper","mapping","markdown","markup","markup-language","mdx","parser","transpiler"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/Adam-Elmi.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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-10-02T20:46:52.000Z","updated_at":"2026-02-17T20:29:43.000Z","dependencies_parsed_at":"2025-10-03T16:27:08.894Z","dependency_job_id":"1cf5426d-8dbf-43bd-acc9-d38f4a5b83b2","html_url":"https://github.com/Adam-Elmi/SomMark","commit_stats":null,"previous_names":["adam-elmi/sommark"],"tags_count":11,"template":false,"template_full_name":null,"purl":"pkg:github/Adam-Elmi/SomMark","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Adam-Elmi%2FSomMark","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Adam-Elmi%2FSomMark/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Adam-Elmi%2FSomMark/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Adam-Elmi%2FSomMark/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Adam-Elmi","download_url":"https://codeload.github.com/Adam-Elmi/SomMark/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Adam-Elmi%2FSomMark/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29993606,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-02T01:47:34.672Z","status":"online","status_checked_at":"2026-03-02T02:00:07.342Z","response_time":60,"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":["docs","documentation","dsl","html","json","json-langugae","langauge","mapper","mapping","markdown","markup","markup-language","mdx","parser","transpiler"],"created_at":"2025-10-10T12:43:45.724Z","updated_at":"2026-04-01T23:56:32.814Z","avatar_url":"https://github.com/Adam-Elmi.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cimg width=\"2000\" height=\"491\" alt=\"SomMark Cover\" src=\"https://raw.githubusercontent.com/Adam-Elmi/SomMark/master/assets/smark_bg.png\" /\u003e\n\n\u003cp align=\"center\"\u003e\nSomMark v3 is a simple, flexible markup language for structured content.\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n\u003c!--License--\u003e\n\u003ca href=\"https://www.npmjs.com/package/sommark\" target=\"_blank\"\u003e\n\u003cimg src=\"https://img.shields.io/badge/license-MIT-green?style=flat-square\" /\u003e\n\u003c/a\u003e\n\n\u003c!--Npm Version--\u003e\n\u003ca href=\"https://www.npmjs.com/package/sommark\" target=\"_blank\"\u003e\n\u003cimg src=\"https://img.shields.io/npm/v/sommark?style=flat-square\" /\u003e\n\u003c/a\u003e\n\n\u003c!--Language Type--\u003e\n\u003cimg src=\"https://img.shields.io/badge/type-markup%20language-orange?style=flat-square\" /\u003e\n\n\u003c!--SomMark Playground--\u003e\n\u003ca href=\"https://adam-elmi.github.io/SomMark-Playground\" target=\"_blank\"\u003e\n\u003cimg \nsrc=\"https://img.shields.io/badge/SomMark-Playground-blue?style=flat-square\" \nalt=\"SomMark Playground Badge\" /\u003e\n\u003c/a\u003e\n\u003c/p\u003e\n\n----\n\n## Try SomMark Playground\n\nTest SomMark live in your browser:  \n[https://adam-elmi.github.io/SomMark-Playground/](https://adam-elmi.github.io/SomMark-Playground/)\n\n----\n\n# What's new in v3?\n\nSomMark v3 is faster, more powerful, and easier to extend.\n\n- **HTML Support**: Full HTML5 Support\n- **Markdown Support**: Full Markdown Support\n- **JSON Support**: Full JSON Support\n- **MDX Support**: Full MDX Support\n- **Plugin System**: Add new features without changing the core code.\n- **Modular Support**: Easily import files and use variables.\n- **Type-Safe Rules**: Set requirements for tags and attributes.\n- **Clean Syntax**: Simplified block, atblock \u0026 inline rules and better error handling.\n\n# Installation\n\n```bash\nnpm install -g sommark\n```\n\n# Usage\n\n## v3 Syntax Example\n\nSomMark is designed to be readable and clear.\n\n```ini\n# Html\n[h1]Welcome to SomMark v3[end]\n\n[section = class: \"hero\", id: \"main\"]\n  [a = href: \"https://sommark.org\"]Visit Website[end]\n[end]\n\n# Markdown\n[quote]\nSomMark is simple and powerful.\n[end]\n\n[bold]Check out our syntax guide![end]\n\n# Json\n[Json= object]\n[Object = \"user\"]\n  (name)-\u003e(string: \"Adam Elmi\")\n  (age)-\u003e(number: 25)\n  (is_active_user)-\u003e(bool: true)\n[end]\n[end]\n```\n\n## Using in JavaScript\n\n```javascript\nimport SomMark from \"sommark\";\n\nconst smark = new SomMark({\n\tsrc: '[h1]Hello World[end]',\n\tformat: \"html\"\n});\n\nconsole.log(await smark.transpile());\n```\n\n# Documentation\n\nRead our detailed guides in the `docs/` folder:\n\n- **[Syntax Guide](docs/03.syntax.md)**: How to write SomMark (Blocks, Inline, At-Blocks).\n- **[Plugin System](docs/19.plugin-system.md)**: How to create your own plugins.\n- **[Built-in Plugins](docs/20.built-in-plugins.md)**: Guide to standard plugins.\n- **[Core API](docs/09.core.md)**: How to use SomMark in your code.\n- **[Mapper API](docs/13.mapper.md)**: How to create new output formats.\n- **[CLI Reference](docs/11.cli.md)**: Terminal commands and flags.\n- **[API Quick Reference](docs/api)**: Fast lookup for all functions.\n\n# Editor Support\n\n### Editor Support\nHigh-quality syntax highlighting and diagnostics are provided via **LSP Semantic Tokens**. This ensures perfect coloring in any editor that supports the Language Server Protocol (e.g., VS Code, Neovim, CoC).\n\nInformation for integration can be found in the [SomMark-LSP](https://github.com/Adam-Elmi/SomMark-LSP) project.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadam-elmi%2Fsommark","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fadam-elmi%2Fsommark","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadam-elmi%2Fsommark/lists"}