Converter.MarkdownToBBCodeNM.Tool 1.0.0.12

Converter.MarkdownToBBCodeNM

Converts Markdown into NexusMods BBCode. Might be opionated with the HTML conversion, since there are a few ways to interpret HTML

Installation

dotnet tool install -g Converter.MarkdownToBBCodeNM.Tool

Usage

When installed as a global tool:

markdown_to_bbcodenm -i "**raw markdown**"
markdown_to_bbcodenm -i "~~raw\r\nmarkdown~~" --disableextended

markdown_to_bbcodenm -i "/markdown.md";
markdown_to_bbcodenm -i "/markdown.md" -o "/bbcode.txt";

-i or --input accepts both raw markdown and a file path.
-o or --output accepts a file path. If specified, will write the converted BBCode to the file instead of outputting to the console.
-d or --disableextended will disable newline detection via two spaces and will disable HTML conversion

Example

At the time of writing the tool, it was used to keep in sync the description of the BLSE mod for Bannerlord.
BLSE - GitHub → NexusMods

Notes

• You can ignore an HTML element by adding converter_ignore attribute to the element

  <p converter_ignore>WILL NOT BE CONVERTED TO BBCODE</p>
  

• You can set an alternative href for an image for NexusMods by adding a nexusmods_href attribute to the element

  <a href="MARKDOWN_LINK" nexusmods_href="NEXUSMODS_LINK" /> </a>
  

• You can set an alternative src for an image for NexusMods by adding a nexusmods_src attribute to the element

  <img src="MARKDOWN_IMAGE" nexusmods_src="NEXUSMODS_IMAGE" />
  

Supporting Codes