{"id":17723359,"url":"https://github.com/bytesnake/ztl","last_synced_at":"2025-07-28T06:06:46.812Z","repository":{"id":258349423,"uuid":"861267360","full_name":"bytesnake/ztl","owner":"bytesnake","description":"Render notes from Markdown, LaTeX and BibTeX to terminal and Mastodon","archived":false,"fork":false,"pushed_at":"2024-10-16T17:44:49.000Z","size":25,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-10-18T15:30:19.087Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Rust","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/bytesnake.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}},"created_at":"2024-09-22T12:59:48.000Z","updated_at":"2024-10-16T17:44:53.000Z","dependencies_parsed_at":"2024-10-18T15:40:28.215Z","dependency_job_id":null,"html_url":"https://github.com/bytesnake/ztl","commit_stats":null,"previous_names":["bytesnake/ztl"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/bytesnake/ztl","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bytesnake%2Fztl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bytesnake%2Fztl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bytesnake%2Fztl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bytesnake%2Fztl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bytesnake","download_url":"https://codeload.github.com/bytesnake/ztl/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bytesnake%2Fztl/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267470062,"owners_count":24092352,"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-07-28T02:00:09.689Z","response_time":68,"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":[],"created_at":"2024-10-25T15:42:44.515Z","updated_at":"2025-07-28T06:06:46.739Z","avatar_url":"https://github.com/bytesnake.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ZTL - Zettel Tools by Lorenz\n\nZtl provides a unified way to render notes from Markdown, LaTeX and BibTeX. Generated cache provides spanning information for editors like ViM and HTML artifacts to publish notes to Mastodon and for live preview with SIXEL enabled terminals.\n\nThe repository provides a terminal tool written in Rust to generate note cache and a Neovim plugin for navigation.\n\n## Features\n\n - render note source from Markdown with [comrak](https://github.com/kivikakk/comrak), LaTeX with [TeX4ht](https://tug.org/tex4ht/) and BibTeX to standalone HTML and MathML\n - abstract files from individual notes, provides linking capabilities between any file format\n - generate unified representation with TOML files to cache folder at `.ztl/cache/` for downstream plugins\n - use span and note information for note navigation and publishing to Mastodon\n\nSupported subcommands of `ztl` are\n\n```bash\nUsage: ztl [OPTIONS] [COMMAND]\n\nCommands:\n  watch    Watch files and rebuild\n  publish  Publish notes to Mastodon instance\n  build    Build all notes from scratch\n  help     Print this message or the help of the given subcommand(s)\n\nOptions:\n  -d, --debug...  Enable debugging\n  -h, --help      Print help\n  -V, --version   Print version\n```\n\n## Example with LaTeX\n\n![example](https://github.com/user-attachments/assets/e96b6fdb-7514-40a9-b3a8-01d5dde9c1bf)\n\n## Published to Mastodon\n\nAll notes are rendered to HTML5 + MathML, hence can also be published to Mastodon:\n\n\u003cp align=\"center\"\u003e\n \u003cimg src=\"https://github.com/user-attachments/assets/001f9414-1b09-4933-95ad-26dc1d9f7231\" width=600 /\u003e\n\u003c/p\u003e\n\n### WIP\n\n - [x] support for Markdown and LaTeX rendering\n - [x] generate cache for navigation plugins in editor\n - [x] publish set of notes to Mastodon\n - [ ] write more complete documentation and installation guide\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbytesnake%2Fztl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbytesnake%2Fztl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbytesnake%2Fztl/lists"}