{"id":18484824,"url":"https://github.com/butr/converter.markdowntobbcode","last_synced_at":"2025-10-31T13:30:39.571Z","repository":{"id":182656977,"uuid":"668401387","full_name":"BUTR/Converter.MarkdownToBBCode","owner":"BUTR","description":"Converts Markdown and HTML into NexusMods and Steam BBCode flavor","archived":false,"fork":false,"pushed_at":"2024-02-23T20:51:10.000Z","size":88,"stargazers_count":2,"open_issues_count":9,"forks_count":2,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-02-16T13:50:15.605Z","etag":null,"topics":["bbcode","html5","markdown","markdown-converter","nexusmods","steam"],"latest_commit_sha":null,"homepage":"","language":"C#","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/BUTR.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":"2023-07-19T18:07:02.000Z","updated_at":"2023-10-09T23:40:15.000Z","dependencies_parsed_at":"2023-11-25T22:24:04.634Z","dependency_job_id":"d5200227-98fe-420d-a45c-102a463ebe58","html_url":"https://github.com/BUTR/Converter.MarkdownToBBCode","commit_stats":null,"previous_names":["butr/converter.markdowntobbcodenm","butr/converter.markdowntobbcode"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BUTR%2FConverter.MarkdownToBBCode","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BUTR%2FConverter.MarkdownToBBCode/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BUTR%2FConverter.MarkdownToBBCode/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BUTR%2FConverter.MarkdownToBBCode/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BUTR","download_url":"https://codeload.github.com/BUTR/Converter.MarkdownToBBCode/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239201642,"owners_count":19599078,"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":["bbcode","html5","markdown","markdown-converter","nexusmods","steam"],"created_at":"2024-11-06T12:43:07.514Z","updated_at":"2025-10-31T13:30:39.537Z","avatar_url":"https://github.com/BUTR.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Converter.MarkdownToBBCode\nConverts Markdown and HTML (GitHub flavor) into NexusMods and Steam BBCode flavor. Might be opionated with the HTML conversion, since there are a few ways to interpret HTML\n\n### Installation\n```shell\ndotnet tool install -g Converter.MarkdownToBBCodeNM.Tool\ndotnet tool install -g Converter.MarkdownToBBCodeSteam.Tool\n```\n\n### Usage\nWhen installed as a global tool:\n```shell\n# NexusMods\nmarkdown_to_bbcodenm -i \"**raw markdown**\"\nmarkdown_to_bbcodenm -i \"~~raw\\r\\nmarkdown~~\" --disableextended\n\nmarkdown_to_bbcodenm -i \"/markdown.md\";\nmarkdown_to_bbcodenm -i \"/markdown.md\" -o \"/bbcode.txt\";\n\n# Steam\nmarkdown_to_bbcodesteam -i \"**raw markdown**\"\nmarkdown_to_bbcodesteam -i \"~~raw\\r\\nmarkdown~~\" --disableextended\n\nmarkdown_to_bbcodesteam -i \"/markdown.md\";\nmarkdown_to_bbcodesteam -i \"/markdown.md\" -o \"/bbcode.txt\";\n```\n`-i or --input` accepts both raw markdown and a file path.  \n`-o or --output` accepts a file path. If specified, will write the\nconverted BBCode to the file instead of outputting to the console.  \n`-d or --disableextended` will disable newline detection via two spaces\nand will disable HTML conversion\n\n## Example\nAt the time of writing the tool, it was used to keep in sync the description of the BLSE mod for Bannerlord.  \nBLSE - [GitHub](https://github.com/BUTR/Bannerlord.BLSE) -\u003e [NexusMods](https://www.nexusmods.com/mountandblade2bannerlord/mods/1)  \nMCM - [GitHub](https://github.com/Aragas/Bannerlord.MBOptionScreen) -\u003e [NexusMods](https://www.nexusmods.com/mountandblade2bannerlord/mods/612) \u0026 [GitHub](https://github.com/Aragas/Bannerlord.MBOptionScreen) -\u003e [Steam](https://steamcommunity.com/sharedfiles/filedetails/?id=2859238197)  \n\n## Notes\n* You can ignore an HTML element by adding `converter_ignore`, `converter_nexusmods`, `converter_steam` attribute to the element\n  ```HTML\n  \u003cp converter_ignore\u003eWILL NOT BE CONVERTED TO BBCODE\u003c/p\u003e\n  \u003cp converter_nexusmods\u003eWILL NOT BE CONVERTED TO BBCODE FOR STEAM\u003c/p\u003e\n  \u003cp converter_steam\u003eWILL NOT BE CONVERTED TO BBCODE FOR NEXUSMODS\u003c/p\u003e\n  ```\n* You can set an alternative `href` for a link for NexusMods/Steam by adding a `nexusmods_href` or `steam_href` attribute to the element\n  ```HTML\n  \u003ca href=\"MARKDOWN_LINK\" nexusmods_href=\"NEXUSMODS_LINK\" /\u003e \u003c/a\u003e\n  ```\n* You can set an alternative `src` for an image for NexusMods/Steam by adding a `nexusmods_src` or `steam_src` attribute to the element\n  ```HTML\n  \u003cimg src=\"MARKDOWN_IMAGE\" nexusmods_src=\"NEXUSMODS_IMAGE\" /\u003e\n  ```\n## Supporting Codes\n[GitHub Markdown Supported HTML Codes](https://github.com/gjtorikian/html-pipeline/blob/a2e02ac8372da5376cde623466dfaeb0f2b2ea1c/lib/html_pipeline/sanitization_filter.rb)  \n[Steam Supported BBCode Codes](https://steamcommunity.com/comment/ForumTopic/formattinghelp)  \n\n| NexusMods BBCode                       | Steam BBCode                       | Markdown (GitHub)                                                         | HTML                                                                   |\n|----------------------------------------|------------------------------------|---------------------------------------------------------------------------|------------------------------------------------------------------------|\n| \\[b\\]TEXT\\[\\b]                         | \\[b\\]TEXT\\[\\b]                     | \\*\\*TEXT\\*\\*                                                              | \\\u003cb\u003eTEXT\\\u003c/b\u003e                                                          |\n| \\[i\\]TEXT\\[/i]                         | \\[i\\]TEXT\\[/i]                     | \\*TEXT\\*                                                                  | \\\u003ci\u003eTEXT\\\u003c/i\u003e                                                          |\n| \\[u]TEXT\\[/u]                          | \\[u]TEXT\\[/u]                      |                                                                           | \\\u003cins\\\u003eTEXT\\\u003c/ins\u003e OR \\\u003cu\\\u003eTEXT\\\u003c/u\u003e                                   |\n| \\[s]TEXT\\[/s]                          | \\[strike]TEXT\\[/strike]            | \\~\\~TEXT\\~\\~                                                              | \\\u003cs\u003eTEXT\\\u003c/s\u003e OR \\\u003cstrike\u003eTEXT\\\u003c/strike\u003e                               |\n| \\[url=URL]TEXT\\[/url]                  | \\[url=URL]TEXT\\[/url]              | \\[TEXT\\]\\(URL\\)                                                           | \\\u003ca href=\"URL\"\\\u003eTEXT\\\u003c/a\u003e                                              |\n| \\[img]URL\\[/img]                       | \\[img]URL\\[/img]                   | \\!\\[Alt text\\]\\(URL\\)                                                     | \\\u003cimg src=\"URL\"\u003e\\\u003c/img\u003e                                                |\n| \\[quote]TEXT\\[/quote]                  | \\[quote]TEXT\\[/quote]              | \\\u003e TEXT                                                                   | \\\u003cblockquote\u003eTEXT\\\u003c/blockquote\u003e                                        |\n| \\[quote AUTHOR]TEXT\\[/quote]           | \\[quote=AUTHOR]TEXT\\[/quote]       | \\\u003e TEXT                                                                   |                                                                        |\n| \\[code]CODE\\[/code]                    | \\[code]CODE\\[/code]                | \\`\\`\\`CODE\\`\\`\\`                                                          | \\\u003ccode\u003eCODE\\\u003c/code\u003e                                                    |\n| \\[list=1]\\[*]ENTRY\\[/list]             | \\[olist]\\[*]ENTRY\\[/olist]         | 1. ENTRY                                                                  | \\\u003col\u003e\\\u003cli\u003eENTRY\\\u003c/li\u003e\\\u003c/ol\u003e                                            |\n| \\[list]\\[*]ENTRY\\[/list]               | \\[list]\\[*]ENTRY\\[/list]           | \\* ENTRY                                                                  | \\\u003cul\u003e\\\u003cli\u003eENTRY\\\u003c/li\u003e\\\u003c/ul\u003e                                            |\n| \\[line]                                | \\[hr]\\[/hr]                        |                                                                           | \\\u003chr/\u003e                                                                 |\n| \\[color=COLOR]TEXT\\[/color]            |                                    |                                                                           |                                                                        |\n| \\[font=FONT]TEXT\\[/font]               |                                    |                                                                           |                                                                        |\n| \\[center]TEXT\\[/center]                |                                    |                                                                           | \\\u003cp align=\\\"center\\\"\\\u003eTEXT\\\u003c/p\u003e OR \\\u003cdiv align=\\\"center\\\"\\\u003eTEXT\\\u003c/div\u003e |\n| \\[right]TEXT\\[/right]                  |                                    |                                                                           | \\\u003cp align=\\\"right\\\"\\\u003eTEXT\\\u003c/p\u003e OR \\\u003cdiv align=\\\"right\\\"\\\u003eTEXT\\\u003c/div\u003e   |\n| \\[left]TEXT\\[/left]                    |                                    |                                                                           | \\\u003cp align=\\\"left\\\"\\\u003eTEXT\\\u003c/p\u003e OR \\\u003cdiv align=\\\"left\\\"\\\u003eTEXT\\\u003c/div\u003e     |\n| \\[size=1]TEXT\\[/size]                  | \\[h6]TEXT\\[/h6]                    | ###### TEXT                                                               | \\\u003ch6\\\u003eTEXT\\\u003c/h6\u003e                                                       |\n| \\[size=2]TEXT\\[/size]                  | \\[h5]TEXT\\[/h5]                    | ##### TEXT                                                                | \\\u003ch5\\\u003eTEXT\\\u003c/h5\u003e                                                       |\n| \\[size=3]TEXT\\[/size]                  | \\[h4]TEXT\\[/h4]                    | #### TEXT                                                                 | \\\u003ch4\\\u003eTEXT\\\u003c/h4\u003e                                                       |\n| \\[size=4]TEXT\\[/size]                  | \\[h3]TEXT\\[/h3]                    | ### TEXT                                                                  | \\\u003ch3\\\u003eTEXT\\\u003c/h3\u003e                                                       |\n| \\[size=5]TEXT\\[/size]                  | \\[h2]TEXT\\[/h2]                    | ## TEXT                                                                   | \\\u003ch2\\\u003eTEXT\\\u003c/h2\u003e                                                       |\n| \\[size=6]TEXT\\[/size]                  | \\[h1]TEXT\\[/h1]                    | # TEXT                                                                    | \\\u003ch1\\\u003eTEXT\\\u003c/h1\u003e                                                       |\n| \\[spoiler]SUMMARY\\\\n\\\\rTEXT\\[/spoiler] | INLINE SPOILERS NOT MAPPED TO HTML |                                                                           | \\\u003cdetails\u003e\\\u003csummary\u003eSUMMARY\\\u003c/summary\u003eTEXT\\\u003c/details\u003e                  |\n| \\[youtube]ID\\[/youtube]                | https://www.youtube.com/watch?v=ID | \\[https://www.youtube.com/watch?v=ID](https://www.youtube.com/watch?v=ID) |                                                                        |\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbutr%2Fconverter.markdowntobbcode","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbutr%2Fconverter.markdowntobbcode","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbutr%2Fconverter.markdowntobbcode/lists"}