{"id":18983617,"url":"https://github.com/notepad-plus-plus/userdefinedlanguages","last_synced_at":"2025-05-16T03:06:25.074Z","repository":{"id":37781958,"uuid":"231619464","full_name":"notepad-plus-plus/userDefinedLanguages","owner":"notepad-plus-plus","description":"Notepad++ User Defined Languages Collection","archived":false,"fork":false,"pushed_at":"2025-05-06T19:50:37.000Z","size":2439,"stargazers_count":656,"open_issues_count":1,"forks_count":408,"subscribers_count":38,"default_branch":"master","last_synced_at":"2025-05-06T20:38:16.315Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Lean","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/notepad-plus-plus.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":null,"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}},"created_at":"2020-01-03T15:56:07.000Z","updated_at":"2025-05-06T19:50:41.000Z","dependencies_parsed_at":"2023-02-19T02:01:14.515Z","dependency_job_id":"7791a18b-e1e2-4320-acf9-9a07a7581a69","html_url":"https://github.com/notepad-plus-plus/userDefinedLanguages","commit_stats":{"total_commits":376,"total_committers":78,"mean_commits":4.82051282051282,"dds":0.7340425531914894,"last_synced_commit":"d9b5d6ba176dee350865a49e48444e33e744b7f3"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/notepad-plus-plus%2FuserDefinedLanguages","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/notepad-plus-plus%2FuserDefinedLanguages/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/notepad-plus-plus%2FuserDefinedLanguages/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/notepad-plus-plus%2FuserDefinedLanguages/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/notepad-plus-plus","download_url":"https://codeload.github.com/notepad-plus-plus/userDefinedLanguages/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254459088,"owners_count":22074605,"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","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-11-08T16:17:46.763Z","updated_at":"2025-05-16T03:06:20.059Z","avatar_url":"https://github.com/notepad-plus-plus.png","language":"Lean","readme":"# Notepad++ User Defined Languages Collection\n\nNotepad++ supports around 80 programming languages for syntax highlighting \u0026 folding.  For languages that are not in the list of languages with built-in support, someone may have created a User Defined Language (UDL) for adding syntax highlighting to the language and added it to this collection, or you can submit a UDL to this collection for others to use.\n\nTo learn all about User Defined Languages:\n\nhttps://npp-user-manual.org/docs/user-defined-language-system/\n\nHere is the UDL list and from where you can download:\n\nhttps://github.com/notepad-plus-plus/userDefinedLanguages/blob/master/udl-list.md\n\n## Using a UDL from this Collection\n\nFor now, you have to manually install a new User Defined Language.\n\n1. Use Notepad++'s **Language \u003e User Defined Language \u003e Open User Defined Language folder...** menu entry to easily find the right `userDefineLangs\\` folder to place your UDL definition file.  (You can copy the path from the file Explorer location bar, for pasting into the **Save As** dialog in step 2)\n2. Download the XML file from the [`UDL list`](./udl-list.md) of this Collection.\n   - From the [`UDL list`](./udl-list.md), click on the name of the file.\n   - From the file's page, use the button labled \"Raw\" to open the source of the UDL.\n       \u003cbr\u003e![image](https://user-images.githubusercontent.com/17455758/193082422-d9c68744-c840-44c4-9e08-85f93985c960.png)\n       \u003cbr\u003eFrom that raw file, you can either:\n       - you can use your browser's **Right Click \u003e Save As...** feature to save the raw XML file to the `userDefineLangs\\` folder found in step 1\n       - copy the text of the file's contents, and paste it into a new file in Notepad++, and save it as an XML file to the `userDefineLangs\\` folder found in step 1\n   - **Warning:** Do not just right click to try to download the file from either the [`UDL list`](./udl-list.md) or the [directory listing on GitHub](https://github.com/notepad-plus-plus/userDefinedLanguages/tree/master/UDLs) links, as either of those right-click actions will download the GitHub web page for that file (which HTML, and _not_ the UDL's XML file and will _not_ work).\n   - Alternatives to step 2 can be found in the [\"Import a UDL\" section](https://npp-user-manual.org/docs/user-defined-language-system/#import-a-udl) of the official online user manual.  But this version here is the easiest for those who haven't worked much with UDLs or GitHub.\n3. Restart Notepad++\n    - Without this restart, Notepad++ will not know about the new UDL.\n4. If the UDL author provided an autoCompletion XML file for that UDL, you may download it from the `autoCompletions\\` folder of the repository (using similar download procedure as described in step 2 above), and put it in a file in the `autoCompletion\\` sub-folder of your Notepad++ installation directory.  More details can be found in the online User Manual in the [\"autoCompletion\"](https://npp-user-manual.org/docs/auto-completion/) and [\"configuration files details\"](https://npp-user-manual.org/docs/config-files/#other-configuration-files) sections.\n5. If the UDL author provided an sample file that uses that UDL, you may download that from the `UDL-samples\\` folder of the repository.  If you open that sample in Notepad++ after the restart from step 3, it should apply the UDL highlighting.\n\n## Submitting your UDL to the Collection\n\nYou can submit your UDL file(s) into this repo, or a (some) link(s) to where your UDL file(s) is (are) hosted.\nIn both cases, you have to do a Pull Request on this repository.\n\nMore information about submitting your UDL to the Collection, please refer to:\n\nhttps://github.com/notepad-plus-plus/userDefinedLanguages/blob/master/CONTRIBUTING.md\n\nWe populated the initial UDLs in this Collection based on the old NppWiki++ list of UDLs (archived at [archive.org](https://web.archive.org/web/20180814202307/http://docs.notepad-plus-plus.org/index.php/User_Defined_Language_Files))\n\nThe original author of any UDL in this Collection may [request](https://github.com/notepad-plus-plus/userDefinedLanguages/issues) that we remove it from the Collection (or submit a PR to do the same), and we will oblige.\n\n## What this Collection Is Not\n\nThis Collection is not for Feature Requests for the Notepad++ User Defined Language system.  If you would like improvements to how Notepad++ uses or implements UDLs, you will have to check if the [Notepad++ Issues](https://github.com/notepad-plus-plus/notepad-plus-plus/issues) already has an issue for your request, and if not, make the request there.  Any feature requests for the system made in the Collection's repository will be moved to the Notepad++ issues list if possible, or will be closed with a message that says it was requested in the wrong place.\n\nThe maintainers of this Collection do not have the knowledge to make a custom User Defined Language definition on request -- you likely know your Language much better that we do.  It is super simple to make your own UDL: paste your language's keywords into one or more of the eight keywords sections, put the appropriate operators into the operators inputs, possibly add some delimiters (like quote-pairs or parentheses pairs) and/or comments definitions and/or folding definitions; set the colors to match your desire, and enjoy.  You can see the online User Manual's [UDL description](https://npp-user-manual.org/docs/user-defined-language-system/) with the details on what all of those mean, and how to use it.  Once you have a working UDL, you can share it with others by [Contributing to the Collection](https://github.com/notepad-plus-plus/notepad-plus-plus/blob/master/CONTRIBUTING.md).  Any feature requests in this Collection's repository to \"create the UDL definition for me\" will be rejected: sorry.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnotepad-plus-plus%2Fuserdefinedlanguages","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnotepad-plus-plus%2Fuserdefinedlanguages","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnotepad-plus-plus%2Fuserdefinedlanguages/lists"}