Markdown to HTML Conversion
Expert skill for converting Markdown documents to HTML using the marked.js library, or writing data conversion scripts; in this case scripts similar to markedJS/marked repository. For custom scripts knowledge is not confined to marked.js, but data conversion methods are utilized from tools like pandoc and gomarkdown/markdown for data conversion; jekyll/jekyll and gohugoio/hugo for templating systems.
The conversion script or tool should handle single files, batch conversions, and advanced configurations.
Core Workflow
- Identify the conversion need - Single file, batch, or template system
- Select the right tool - See Tool Selection Guide below
- Load the appropriate reference - Read the tool-specific reference file
- Apply conversion patterns - Use the conversion examples from references
- Handle security - Sanitize output when processing untrusted input
Tool Selection Guide
Choose the tool based on the user's environment and requirements:
| Tool |
Best For |
Language |
Install |
| marked |
Node.js projects, browser usage, CLI quick conversions |
JavaScript |
npm install -g marked |
| pandoc |
Multi-format conversion (MD, HTML, PDF, DOCX, LaTeX) |
Haskell |
pandoc.org/installing |
| gomarkdown |
Go projects, custom parsers, AST manipulation |
Go |
go get github.com/gomarkdown/markdown |
| jekyll |
Blog-aware static sites, GitHub Pages |
Ruby |
gem install jekyll bundler |
| hugo |
Fast static sites, complex content management |
Go |
gohugo.io/installation |
Decision Logic
- Just need quick MD-to-HTML? Use
marked (CLI) or pandoc
- Node.js project? Use
marked
- Need PDF/DOCX/LaTeX output? Use
pandoc
- Go project? Use
gomarkdown
- Building a blog/static site? Use
jekyll (Ruby) or hugo (Go)
- Need GitHub Pages compatibility? Use
jekyll
- Need fast build times? Use
hugo
Conversion Reference Files
Markdown Element Conversion Examples
Load these when working on conversion logic to understand how specific Markdown elements map to HTML.
| Reference |
When to Load |
| basic-markdown-to-html.md |
Headings, paragraphs, inline formatting, links, images, lists, blockquotes, footnotes |
| code-blocks-to-html.md |
Fenced code blocks, syntax highlighting, showing backticks, diagrams |
| collapsed-sections-to-html.md |
<details>/<summary> elements, open-by-default sections |
| tables-to-html.md |
Tables with alignment, formatted content in cells, escaped characters |
| writing-mathematical-expressions-to-html.md |
Inline math ($...$), block math ($$...$$), MathML output |
Markdown Syntax References
Load these when users need help writing Markdown (not converting it).
| Reference |
When to Load |
| basic-markdown.md |
Full Markdown writing syntax reference |
| code-blocks.md |
Code block syntax and language identifiers |
| collapsed-sections.md |
Collapsible section syntax |
| tables.md |
Table formatting syntax |
| writing-mathematical-expressions.md |
LaTeX math expression syntax |
Tool-Specific References
Load the appropriate reference based on the tool selected.
| Reference |
When to Load |
| marked.md |
Using marked.js: CLI usage, Node.js API, config files, batch conversion, security (DOMPurify) |
| pandoc.md |
Using pandoc: multi-format conversion, extensions, templates, Lua filters, batch scripts |
| gomarkdown.md |
Using gomarkdown: Go API, parser/renderer config, AST manipulation, security (Bluemonday) |
| jekyll.md |
Using Jekyll: site creation, Liquid templates, Kramdown config, plugins, front matter |
| hugo.md |
Using Hugo: site creation, Go templates, Goldmark config, shortcodes, Hugo Pipes |
1---2name: markdown-to-html3description: Convert Markdown files to HTML similar to `marked.js`, `pandoc`, `gomarkdown/markdown`, or similar tools; or writing custom script to convert markdown to html and/or working on web template systems like `jekyll/jekyll`, `gohugoio/hugo`, or similar web templating systems that utilize markdown documents, converting them to html. Use when asked to "convert markdown to html", "transform md to html", "render markdown", "generate html from markdown", or when working with .md files and/or web a templating system that converts markdown to HTML output. Supports CLI and Node.js workflows with GFM, CommonMark, and standard Markdown flavors.4---56# Markdown to HTML Conversion78Expert skill for converting Markdown documents to HTML using the marked.js library, or writing data conversion scripts; in this case scripts similar to [markedJS/marked](https://github.com/markedjs/marked) repository. For custom scripts knowledge is not confined to `marked.js`, but data conversion methods are utilized from tools like [pandoc](https://github.com/jgm/pandoc) and [gomarkdown/markdown](https://github.com/gomarkdown/markdown) for data conversion; [jekyll/jekyll](https://github.com/jekyll/jekyll) and [gohugoio/hugo](https://github.com/gohugoio/hugo) for templating systems.910The conversion script or tool should handle single files, batch conversions, and advanced configurations.1112## Core Workflow13141. **Identify the conversion need** - Single file, batch, or template system152. **Select the right tool** - See Tool Selection Guide below163. **Load the appropriate reference** - Read the tool-specific reference file174. **Apply conversion patterns** - Use the conversion examples from references185. **Handle security** - Sanitize output when processing untrusted input1920## Tool Selection Guide2122Choose the tool based on the user's environment and requirements:2324| Tool | Best For | Language | Install |25|------|----------|----------|---------|26| [marked](references/marked.md) | Node.js projects, browser usage, CLI quick conversions | JavaScript | `npm install -g marked` |27| [pandoc](references/pandoc.md) | Multi-format conversion (MD, HTML, PDF, DOCX, LaTeX) | Haskell | [pandoc.org/installing](https://pandoc.org/installing.html) |28| [gomarkdown](references/gomarkdown.md) | Go projects, custom parsers, AST manipulation | Go | `go get github.com/gomarkdown/markdown` |29| [jekyll](references/jekyll.md) | Blog-aware static sites, GitHub Pages | Ruby | `gem install jekyll bundler` |30| [hugo](references/hugo.md) | Fast static sites, complex content management | Go | [gohugo.io/installation](https://gohugo.io/installation/) |3132### Decision Logic3334- **Just need quick MD-to-HTML?** Use `marked` (CLI) or `pandoc`35- **Node.js project?** Use `marked`36- **Need PDF/DOCX/LaTeX output?** Use `pandoc`37- **Go project?** Use `gomarkdown`38- **Building a blog/static site?** Use `jekyll` (Ruby) or `hugo` (Go)39- **Need GitHub Pages compatibility?** Use `jekyll`40- **Need fast build times?** Use `hugo`4142## Conversion Reference Files4344### Markdown Element Conversion Examples4546Load these when working on conversion logic to understand how specific Markdown elements map to HTML.4748| Reference | When to Load |49|-----------|-------------|50| [basic-markdown-to-html.md](references/basic-markdown-to-html.md) | Headings, paragraphs, inline formatting, links, images, lists, blockquotes, footnotes |51| [code-blocks-to-html.md](references/code-blocks-to-html.md) | Fenced code blocks, syntax highlighting, showing backticks, diagrams |52| [collapsed-sections-to-html.md](references/collapsed-sections-to-html.md) | `<details>`/`<summary>` elements, open-by-default sections |53| [tables-to-html.md](references/tables-to-html.md) | Tables with alignment, formatted content in cells, escaped characters |54| [writing-mathematical-expressions-to-html.md](references/writing-mathematical-expressions-to-html.md) | Inline math (`$...$`), block math (`$$...$$`), MathML output |5556### Markdown Syntax References5758Load these when users need help writing Markdown (not converting it).5960| Reference | When to Load |61|-----------|-------------|62| [basic-markdown.md](references/basic-markdown.md) | Full Markdown writing syntax reference |63| [code-blocks.md](references/code-blocks.md) | Code block syntax and language identifiers |64| [collapsed-sections.md](references/collapsed-sections.md) | Collapsible section syntax |65| [tables.md](references/tables.md) | Table formatting syntax |66| [writing-mathematical-expressions.md](references/writing-mathematical-expressions.md) | LaTeX math expression syntax |6768### Tool-Specific References6970Load the appropriate reference based on the tool selected.7172| Reference | When to Load |73|-----------|-------------|74| [marked.md](references/marked.md) | Using marked.js: CLI usage, Node.js API, config files, batch conversion, security (DOMPurify) |75| [pandoc.md](references/pandoc.md) | Using pandoc: multi-format conversion, extensions, templates, Lua filters, batch scripts |76| [gomarkdown.md](references/gomarkdown.md) | Using gomarkdown: Go API, parser/renderer config, AST manipulation, security (Bluemonday) |77| [jekyll.md](references/jekyll.md) | Using Jekyll: site creation, Liquid templates, Kramdown config, plugins, front matter |78| [hugo.md](references/hugo.md) | Using Hugo: site creation, Go templates, Goldmark config, shortcodes, Hugo Pipes |
atc-net