{"id":30450193,"url":"https://github.com/nochso/tocenize","last_synced_at":"2025-08-23T13:25:55.430Z","repository":{"id":57482441,"uuid":"72985481","full_name":"nochso/tocenize","owner":"nochso","description":"Insert and maintain a table of contents in Markdown files.","archived":false,"fork":false,"pushed_at":"2018-06-18T22:04:34.000Z","size":45,"stargazers_count":33,"open_issues_count":3,"forks_count":4,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-11-17T12:48:02.609Z","etag":null,"topics":["cli","markdown","markdown-toc","table-of-contents","toc"],"latest_commit_sha":null,"homepage":"","language":"Go","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/nochso.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}},"created_at":"2016-11-06T11:12:40.000Z","updated_at":"2024-03-26T02:27:07.000Z","dependencies_parsed_at":"2022-09-02T06:20:13.673Z","dependency_job_id":null,"html_url":"https://github.com/nochso/tocenize","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/nochso/tocenize","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nochso%2Ftocenize","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nochso%2Ftocenize/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nochso%2Ftocenize/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nochso%2Ftocenize/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nochso","download_url":"https://codeload.github.com/nochso/tocenize/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nochso%2Ftocenize/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271749048,"owners_count":24814115,"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-23T02:00:09.327Z","response_time":69,"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":["cli","markdown","markdown-toc","table-of-contents","toc"],"created_at":"2025-08-23T13:25:54.023Z","updated_at":"2025-08-23T13:25:55.376Z","avatar_url":"https://github.com/nochso.png","language":"Go","readme":"tocenize\n========\n\n[![MIT license](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)\n[![GitHub release](https://img.shields.io/github/release/nochso/tocenize.svg)](https://github.com/nochso/tocenize/releases)\n[![Go Report Card](https://goreportcard.com/badge/github.com/nochso/tocenize)](https://goreportcard.com/report/github.com/nochso/tocenize)\n[![Build Status](https://travis-ci.org/nochso/tocenize.svg?branch=master)](https://travis-ci.org/nochso/tocenize)\n[![Coverage Status](https://coveralls.io/repos/github/nochso/tocenize/badge.svg?branch=master)](https://coveralls.io/github/nochso/tocenize?branch=master)\n\nInsert and maintain a table of contents in Markdown files.\n\n- [Features](#features)\n- [Installation](#installation)\n\t- [Pre-compiled binaries](#pre-compiled-binaries)\n\t- [From source](#from-source)\n- [Usage](#usage)\n- [Alternatives](#alternatives)\n- [Changes](#changes)\n- [License](#license)\n\n\nFeatures\n--------\n\ntocenize generates a TOC (table of content) from Markdown files and inserts or\nupdates it in the given file.\n\n- Cross-platform command line utility\n  - Windows, Linux, Mac and *bsd (anything the Go compiler will handle)\n- Anchor links are compatible to GFM (Github flavoured Markdown)\n- Automatic \"intelligent\" insertion of new TOC\n- Update existing TOCs without moving it\n- Configurable max. and min. header depth\n- Line endings are kept intact (LF or CRLF is detected and then used for new lines)\n\n\nInstallation\n------------\n\n\n### Pre-compiled binaries\n\nCompiled binaries are available on the [releases page][releases].\n\nMake sure to place it somewhere in your `$PATH`.\n\n\n### From source\n\nIf you have a working Go environment, simply run:\n\n```\ngo install github.com/nochso/tocenize/cmd/tocenize\n```\n\nIf you've added `$GOPATH/bin` to your `$PATH`, you can now run `tocenize` from\nanywhere.\n\nUsage\n-----\n\nThe output of `tocenize -h` should be self explanatory:\n\n```\ntocenize [options] FILE...\n\n  -d    print full diff to stdout\n  -e    update only existing TOC (no insert)\n  -indent string\n        string used for nesting (default \"\\t\")\n  -max int\n        maximum depth (default 99)\n  -min int\n        minimum depth (default 1)\n  -p    print full result to stdout\n  -v    print version\n```\n\n\nAlternatives\n------------\n\n- [github.com/axelbellec/gotoc](https://github.com/axelbellec/gotoc) inserts on\n  top, doesn't update existing TOC, doesn't support setext-style headers\n\n\nChanges\n-------\n\nAll notable changes to this project will be documented in the [changelog].\n\nThe format is based on [Keep a Changelog](http://keepachangelog.com/) and this\nproject adheres to [Semantic Versioning](http://semver.org/).\n\n\nLicense\n-------\n\nThis project is released under the [MIT license](LICENSE).\n\n\n[changelog]: CHANGELOG.md\n[releases]: https://github.com/nochso/tocenize/releases\n[Go]: https://golang.org","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnochso%2Ftocenize","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnochso%2Ftocenize","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnochso%2Ftocenize/lists"}