{"id":20475299,"url":"https://github.com/vim-utilities/markdown-headings","last_synced_at":"2026-04-20T14:35:26.527Z","repository":{"id":181324292,"uuid":"282721807","full_name":"vim-utilities/markdown-headings","owner":"vim-utilities","description":"Vim plugin that adds short-cuts/commands for MarkDown headings","archived":false,"fork":false,"pushed_at":"2024-07-01T22:28:24.000Z","size":25,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-05T14:30:37.412Z","etag":null,"topics":["markdown","plugin","vim"],"latest_commit_sha":null,"homepage":"","language":"Vim Script","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vim-utilities.png","metadata":{"files":{"readme":".github/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},"funding":{"liberapay":"vim-utilities"}},"created_at":"2020-07-26T19:47:52.000Z","updated_at":"2024-07-01T22:28:27.000Z","dependencies_parsed_at":"2023-07-15T00:25:42.268Z","dependency_job_id":"da8c0b86-d312-454f-85dd-234986cd56cb","html_url":"https://github.com/vim-utilities/markdown-headings","commit_stats":null,"previous_names":["vim-utilities/markdown-headings"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/vim-utilities/markdown-headings","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vim-utilities%2Fmarkdown-headings","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vim-utilities%2Fmarkdown-headings/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vim-utilities%2Fmarkdown-headings/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vim-utilities%2Fmarkdown-headings/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vim-utilities","download_url":"https://codeload.github.com/vim-utilities/markdown-headings/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vim-utilities%2Fmarkdown-headings/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32050967,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-20T11:35:06.609Z","status":"ssl_error","status_checked_at":"2026-04-20T11:34:48.899Z","response_time":94,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["markdown","plugin","vim"],"created_at":"2024-11-15T15:15:38.383Z","updated_at":"2026-04-20T14:35:26.504Z","avatar_url":"https://github.com/vim-utilities.png","language":"Vim Script","funding_links":["https://liberapay.com/vim-utilities"],"categories":[],"sub_categories":[],"readme":"# Markdown Headings\n[heading__top]:\n  #markdown-headings\n  \"\u0026#x2B06; Vim plugin that adds short-cuts/commands for MarkDown headings\"\n\n\nVim plugin that adds short-cuts/commands for MarkDown headings\n\n\n## [![Byte size of Markdown Headings][badge__main__markdown_headings__source_code]][markdown_headings__main__source_code] [![Open Issues][badge__issues__markdown_headings]][issues__markdown_headings] [![Open Pull Requests][badge__pull_requests__markdown_headings]][pull_requests__markdown_headings] [![Latest commits][badge__commits__markdown_headings__main]][commits__markdown_headings__main]\n\n\n------\n\n\n- [:arrow_up: Top of Document][heading__top]\n- [:building_construction: Requirements][heading__requirements]\n- [:zap: Quick Start][heading__quick_start]\n- [\u0026#x1F9F0; Usage][heading__usage]\n- [\u0026#x1F5D2; Notes][heading__notes]\n- [:card_index: Attribution][heading__attribution]\n- [:balance_scale: Licensing][heading__license]\n\n\n------\n\n\n\n## Requirements\n[heading__requirements]:\n  #requirements\n  \"\u0026#x1F3D7; Prerequisites and/or dependencies that this project needs to function properly\"\n\n\nThis repository requires the [Vim][link__vim_home] text editor to be installed\nthe source code is available on [GitHub -- `vim/vim`][link__vim_github], and\nmost GNU Linux package managers are able to install Vim directly, eg...\n\n\n- Arch based Operating Systems\n   ```bash\n   sudo packman -Syy\n\n   sudo packman -S gawk make vim\n   ```\n- Debian derived Distributions\n   ```bash\n   sudo apt-get update\n\n   sudo apt-get install gawk make vim\n   ```\n\n\n\u003e Note `gawk` and `make` are only required if **not** utilizing a Vim plugin\n\u003e manager.\n\n\n______\n\n\n## Quick Start\n[heading__quick_start]:\n  #quick-start\n  \"\u0026#9889; Perhaps as easy as one, 2.0,...\"\n\n\nClone this project...\n\n\n```bash\nmkdir -vp ~/git/hub/vim-utilities\n\ncd ~/git/hub/vim-utilities\n\ngit clone git@github.com:vim-utilities/markdown-headings.git\n```\n\n\n---\n\n\nIf **not** using a plugin manager, then this plugin may be installed via `make install` command...\n\n\n```bash\ncd ~/git/hub/vim-utilities/markdown-headings\n\nmake install\n```\n\n\n---\n\n\nTo upgrade in the future use `make upgrade` command...\n\n\n```bash\ncd ~/git/hub/vim-utilities/markdown-headings\n\nmake upgrade\n```\n\n\n---\n\n\nAfter installation, plugin documentation may be accessed via Vim's `:help` command, eg...\n\n\n```Vim\n:help markdown-heading-transform\n\n:help markdown-heading-link\n```\n\n\n______\n\n\n## Usage\n[heading__usage]:\n  #usage\n  \"\u0026#x1F9F0; How to utilize this project\"\n\n\nFeatures of this plugin automatically activate if detected `filetype` is `markdown`\n\n\n**Example Usage**\n\n\n0. Write a line of text...\n\n\n```MarkDown\nHeading line to be\n```\n\n1. Use Vim leader sequence to convert line into level `2` MarkDown heading...\n\n\n```Vim\n\u003cLeader\u003eh2\n```\n\n2. Example results...\n\n\n```MarkDown\n## Heading line to be\n```\n\n\n3. Use Vim command to build Heading Link with title text...\n\n\n```Vim\n:Hl Text about heading\n```\n\n\n4. Example results...\n\n\n```MarkDown\n## Heading line to be\n[heading__heading_line_to_be]: #heading-line-to-be \"Text about heading\"\n```\n\n\n5. Edit text of heading...\n\n\n```MarkDown\n## Edited heading line\n[heading__heading_line_to_be]: #heading-line-to-be \"Text about heading\"\n```\n\n6. Use Vim leader sequence to update Heading Link...\n\n\n```Vim\n\u003cLeader\u003ehl\n```\n\n\n7. Example results...\n\n\n```MarkDown\n## Edited heading line\n[heading__edited_heading_line]: #edited-heading-line \"Text about heading\"\n```\n\n\n... Note, either `:Hl` or `\u003cLeader\u003ehl` will update any references to the heading within the document too!\n\n\nFor example for a table of contents similar to...\n\n\n```MarkDown\n- [Link to Some Heading][heading__heading_line_to_be]\n```\n\n\n... would be updated to...\n\n\n```MarkDown\n- [Link to Some Heading][heading__edited_heading_line]\n```\n\n\n8. Convert the level two heading to a level three heading...\n\n\n```Vim\n\u003cLeader\u003eh3\n```\n\n\n... example results...\n\n\n```Vim\n### Edited heading line\n```\n\n\n______\n\n\n## Notes\n[heading__notes]:\n  #notes\n  \"\u0026#x1F5D2; Additional things to keep in mind when developing\"\n\n\nNotice, some MarkDown interpreters may _sanitize_ symbols within heading text\nslightly different to GitHub.\n\n---\n\nThis repository may not be feature complete and/or fully functional, Pull\nRequests that add features or fix bugs are certainly welcomed.\n\n- [Fork][markdown_headings__fork_it] this repository to an account that you have write permissions for.\n\n- Add remote for fork URL. The URL syntax is _`git@github.com:\u003cNAME\u003e/\u003cREPO\u003e.git`_...\n\n```bash\ncd ~/git/hub/vim-utilities/markdown-headings\n\ngit remote add fork git@github.com:\u003cNAME\u003e/markdown-headings.git\n```\n\n- Commit your changes and push to your fork, eg. to fix an issue...\n\n```bash\ncd ~/git/hub/vim-utilities/markdown-headings\n\n\ngit commit -F- \u003c\u003c'EOF'\n:bug: Fixes #42 Issue\n\n\n**Edits**\n\n\n- `\u003cSCRIPT-NAME\u003e` script, fixes some bug reported in issue\nEOF\n\n\ngit push fork main\n```\n\n\u003e Note, the `-u` option may be used to set `fork` as the default remote, eg.\n\u003e _`git push fork main`_ however, this will also default the `fork` remote for\n\u003e pulling from too! Meaning that pulling updates from `origin` must be done\n\u003e explicitly, eg. _`git pull origin main`_\n\n- Then on GitHub submit a Pull Request through the Web-UI, the URL syntax is\n  _`https://github.com/\u003cNAME\u003e/\u003cREPO\u003e/pull/new/\u003cBRANCH\u003e`_\n\n\u003e Note; to decrease the chances of your Pull Request needing modifications\n\u003e before being accepted, please check the\n\u003e [dot-github](https://github.com/vim-utilities/.github) repository for\n\u003e detailed contributing guidelines.\n\n\n______\n\n\n## Attribution\n[heading__attribution]:\n  #attribution\n  \"\u0026#x1F4C7; Resources that where helpful in building this project so far.\"\n\n\n- [Dev Hints -- Vim Help](https://devhints.io/vim-help)\n- [Gist -- An overview of what belongs in each directory of a Vim plugin](https://gist.github.com/nelstrom/1056049/784e252c3de653e204e9e128653010e19fbd493f)\n- [GitHub -- `github-utilities/make-readme`](https://github.com/github-utilities/make-readme)\n- [Learn Vimscript the Hard Way -- Function Arguments](https://learnvimscriptthehardway.stevelosh.com/chapters/24.html)\n- [StackExchange -- How to write a gvim-help-doc-like text file?](https://stackoverflow.com/questions/5576091/)\n- [StackOverflow -- How to insert text from a variable at current cursor position](https://vi.stackexchange.com/questions/21825/)\n- [StackOverflow -- Save current line in variable](https://stackoverflow.com/questions/13821350/)\n- [StackOverflow -- vim how to pass arguments to functions from user commands](https://stackoverflow.com/questions/3213657/)\n- [YouTube -- Start Turning vim into a /comfy/ IDE! -- Luke Smith](https://www.youtube.com/watch?v=Q4I_Ft-VLAg)\n\n\n______\n\n\n## License\n[heading__license]:\n  #license\n  \"\u0026#x2696; Legal side of Open Source\"\n\n\n```\nVim plugin that adds short-cuts/commands for MarkDown headings\nCopyright (C) 2024 S0AndS0\n\nThis program is free software: you can redistribute it and/or modify\nit under the terms of the GNU Affero General Public License as published\nby the Free Software Foundation, version 3 of the License.\n\nThis program is distributed in the hope that it will be useful,\nbut WITHOUT ANY WARRANTY; without even the implied warranty of\nMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\nGNU Affero General Public License for more details.\n\nYou should have received a copy of the GNU Affero General Public License\nalong with this program.  If not, see \u003chttps://www.gnu.org/licenses/\u003e.\n```\n\n\nFor further details review full length version of\n[AGPL-3.0][branch__current__license] License.\n\n\n\n[branch__current__license]:\n  /LICENSE\n  \"\u0026#x2696; Full length version of AGPL-3.0 License\"\n\n[badge__commits__markdown_headings__main]:\n  https://img.shields.io/github/last-commit/vim-utilities/markdown-headings/main.svg\n\n[commits__markdown_headings__main]:\n  https://github.com/vim-utilities/markdown-headings/commits/main\n  \"\u0026#x1F4DD; History of changes on this branch\"\n\n[markdown_headings__community]:\n  https://github.com/vim-utilities/markdown-headings/community\n  \"\u0026#x1F331; Dedicated to functioning code\"\n\n[issues__markdown_headings]:\n  https://github.com/vim-utilities/markdown-headings/issues\n  \"\u0026#x2622; Search for and _bump_ existing issues or open new issues for project maintainer to address.\"\n\n[markdown_headings__fork_it]:\n  https://github.com/vim-utilities/markdown-headings/\n  \"\u0026#x1F531; Fork it!\"\n\n[pull_requests__markdown_headings]:\n  https://github.com/vim-utilities/markdown-headings/pulls\n  \"\u0026#x1F3D7; Pull Request friendly, though please check the Community guidelines\"\n\n[markdown_headings__main__source_code]:\n  https://github.com/vim-utilities/markdown-headings/\n  \"\u0026#x2328; Project source!\"\n\n[badge__issues__markdown_headings]:\n  https://img.shields.io/github/issues/vim-utilities/markdown-headings.svg\n\n[badge__pull_requests__markdown_headings]:\n  https://img.shields.io/github/issues-pr/vim-utilities/markdown-headings.svg\n\n[badge__main__markdown_headings__source_code]:\n  https://img.shields.io/github/repo-size/vim-utilities/markdown-headings\n\n[link__vim_home]:\n  https://www.vim.org\n  \"Home page for the Vim text editor\"\n\n[link__vim_github]:\n  https://github.com/vim/vim\n  \"Source code for Vim on GitHub\"\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvim-utilities%2Fmarkdown-headings","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvim-utilities%2Fmarkdown-headings","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvim-utilities%2Fmarkdown-headings/lists"}