A lightweight, reliable, and secure Markdown ⇄ HTML, Smart Plain Text ⇄ HTML and AmigaGuide → HTML converter built in C#.
👉 GitHub repository: milos-p-lab/MarkdownGuideHtmlConverter
.md
to valid HTML5 .html
Supports:
#
, ##
, ###
, etc.)Heading\n===
for H1 or Heading\n---
for H2)H~2~O
, E=mc^2^
)[TOC]
.html
to Markdown .md
Supports:
<h1>
–<h6>
)<strong>
, <em>
, <del>
, <mark>
)<sub>
, <sup>
)<span class="lang-en">
)alt
and title
attributes (e.g., <img src="..." alt="..." title="...">
)| --- | :---: | ---: |
)<pre>...</pre>
)<pre><code class="language-csharp">...</code></pre>
)<head>
.guide
files to HTML .html
@NODE
, @ENDNODE
, @TOC
, @NEXT
, @PREV
)@DATABASE
, @VER$
, @(C)
, @TITLE
, @AUTHOR
)@{B}
, @{I}
, @{U}
, @{PLAIN}
, @{"Doc" ALINK "doc.guide/intro"}
, @{"Doc" SYSTEM "<command> doc.readme"}
).txt
files to HTML .html
Supports:
Heading\n===
for H1 or Heading\n---
for H2) or uppercase headings (e.g., ` HEADING for H1 or
HEADING` for H2).-
, *
, +
, or •
)<
, >
, &
) automatically.html
to Plain Text .txt
Supports:
Heading\n===
for H1 or Heading\n---
for H2)| --- | :---: | ---: |
)This library was built with one major principle in mind:
Minimal, dependency-free, plug-and-play Markdown ⇄ HTML, AmigaGuide → HTML/MD, and Smart plain text → HTML conversion.
It is designed to be seamlessly integrated into:
Just copy the C# class into your project and use it directly:
string html = ConvMarkdownHtml.Convert(markdown);
string markdown = ConvHtmlMarkdown.Convert(html);
string html = ConvGuideHtml.Convert(amigaGuide);
string html = ConvHtmlMarkdown.SmartTxtConvert(txt);
string txt = ConvHtmlMarkdown.ConvertToTxt(html);
No runtime dependencies, no configuration, no surprises.
While powerful, they come with limitations:
For real-world apps — performance, control, and safety matter.
Read the full story here: 👉 Why I Built This Converter
No setup needed — just download mdoc.exe and run:
mdoc input.md output.html
mdoc input.md output.txt
mdoc input.html output.md
mdoc input.html output.txt
mdoc input.txt output.html
mdoc input.txt output.md
mdoc input.guide output.html
mdoc input.guide output.md
mdoc input.guide output.txt
Works on Windows with .NET Framework 4.0+
Interested in what’s next? 👉 See the Roadmap
Have ideas or want to contribute? 👉 Open an issue or discussion
This converter was built to fill the real gaps left by many existing tools:
If you find it useful, consider starring the GitHub repo ⭐ and sharing the blog post that explains why it was created.
This helps others discover a safer and more powerful alternative to bloated or limited Markdown tools.
✍️ Author: Miloš Perunović