Official agent skill

Markdown To HTML

by github in github/awesome-copilot

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…

OfficialMITAuto-check passedDocuments & Office

Install Markdown To HTML

skills CLI
$ npx skills add github/awesome-copilot --skill markdown-to-html -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install github/awesome-copilot markdown-to-html --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/github/awesome-copilot.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/markdown-to-html .claude/skills/markdown-to-html && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
markdown-to-html
GitHub stars
40k
Used in
1 other repo
Token cost
~6.2k tokens
SKILL.md length
1,302 words
Files
16 (incl. references)
Skills in repo
417
Repo updated
First seen
Licence
MIT

At a glance

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…

  • Asked to convert markdown to html
  • SKILL.md covers When to Use This Skill, Converting Markdown to HTML, Working with markedJS/marked and Working with pandoc, plus 1 more section
  • Calls pandoc, bundle and go; reaches github.com and w3.org
  • Transform md to html

What it does

Markdown To HTML is an agent skill from github/awesome-copilot, published by the product's own GitHub organization. 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…

Its SKILL.md is about 6.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 16 other files, including reference files (for example `references/basic-markdown-to-html.md`, `references/basic-markdown.md` and `references/code-blocks-to-html.md`).

It sits in Documents & Office, covering Markdown and Static sites and blogs. It works with Pandoc and Node.js. The repository describes itself as: Community-contributed instructions, agents, skills, and configurations to help you make the most of GitHub Copilot. The licence is MIT.

When your agent uses it

  • Asked to convert markdown to html
  • Transform md to html
  • Render markdown
  • Generate html from markdown

Example prompts

  • “convert markdown to html”
  • “transform md to html”
  • “render markdown”
  • “/markdown-to-html”

Requirements

  • Node.js

What it can do on your machine

Read from SKILL.md and the folder at commit 727ff2e. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • pandoc
    • bundle
    • go
    • git
    • npm
    • gem

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • github.com
    • w3.org

    Also links to:

    • jekyllrb.com
    • pandoc.org
    • gohugo.io
    • marked.js.org
    • pkg.go.dev
    • markdownguide.org
    • blog.kowalczyk.info

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Markdown To HTML loads about 6.2k tokens when it runs, and up to ~29k if it reads all its reference files. Until then it costs about 164 tokens; SKILL.md has 1,302 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~164
When it runs · the whole SKILL.md, loaded when a task matches
~6.2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~29k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from github/awesome-copilot at commit 727ff2e, republished under its MIT licence (© github). 1,302 words, ~6,151 tokens.

Download SKILL.mdSave it as .claude/skills/markdown-to-html/SKILL.md (or your agent's skills folder). This skill also uses 15 other files; get the full folder from GitHub.
name
markdown-to-html
description
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.

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.

When to Use This Skill

  • User asks to "convert markdown to html" or "transform md files"
  • User wants to "render markdown" as HTML output
  • User needs to generate HTML documentation from .md files
  • User is building static sites from Markdown content
  • User is building template system that converts markdown to html
  • User is working on a tool, widget, or custom template for an existing templating system
  • User wants to preview Markdown as rendered HTML

Converting Markdown to HTML

Essential Basic Conversions

For more see basic-markdown-to-html.md

text
    ```markdown
    # Level 1
    ## Level 2

    One sentence with a [link](https://example.com), and a HTML snippet like `<p>paragraph tag</p>`.

    - `ul` list item 1
    - `ul` list item 2

    1. `ol` list item 1
    2. `ol` list item 1

    | Table Item | Description |
    | One | One is the spelling of the number `1`. |
    | Two | Two is the spelling of the number `2`. |

    ```js
    var one = 1;
    var two = 2;

    function simpleMath(x, y) {
     return x + y;
    }
    console.log(simpleMath(one, two));
    ```
    ```

    ```html
    <h1>Level 1</h1>
    <h2>Level 2</h2>

    <p>One sentence with a <a href="https://example.com">link</a>, and a HTML snippet like <code>&lt;p&gt;paragraph tag&lt;/p&gt;</code>.</p>

    <ul>
     <li>`ul` list item 1</li>
     <li>`ul` list item 2</li>
    </ul>

    <ol>
     <li>`ol` list item 1</li>
     <li>`ol` list item 2</li>
    </ol>

    <table>
     <thead>
      <tr>
       <th>Table Item</th>
       <th>Description</th>
      </tr>
     </thead>
     <tbody>
      <tr>
       <td>One</td>
       <td>One is the spelling of the number `1`.</td>
      </tr>
      <tr>
       <td>Two</td>
       <td>Two is the spelling of the number `2`.</td>
      </tr>
     </tbody>
    </table>

    <pre>
     <code>var one = 1;
     var two = 2;

     function simpleMath(x, y) {
      return x + y;
     }
     console.log(simpleMath(one, two));</code>
    </pre>
    ```
Code Block Conversions

For more see code-blocks-to-html.md

text

    ```markdown
    your code here
    ```

    ```html
    <pre><code class="language-md">
    your code here
    </code></pre>
    ```

    ```js
    console.log("Hello world");
    ```

    ```html
    <pre><code class="language-js">
    console.log("Hello world");
    </code></pre>
    ```

    ```markdown
      ```

      ```
      visible backticks
      ```

      ```
    ```

    ```html
      <pre><code>
      ```

      visible backticks

      ```
      </code></pre>
    ```
Collapsed Section Conversions

For more see collapsed-sections-to-html.md

text
    ```markdown
    <details>
    <summary>More info</summary>

    ### Header inside

    - Lists
    - **Formatting**
    - Code blocks

        ```js
        console.log("Hello");
        ```

    </details>
    ```

    ```html
    <details>
    <summary>More info</summary>

    <h3>Header inside</h3>

    <ul>
     <li>Lists</li>
     <li><strong>Formatting</strong></li>
     <li>Code blocks</li>
    </ul>

    <pre>
     <code class="language-js">console.log("Hello");</code>
    </pre>

    </details>
    ```
Mathematical Expression Conversions

For more see writing-mathematical-expressions-to-html.md

text
    ```markdown
    This sentence uses `$` delimiters to show math inline: $\sqrt{3x-1}+(1+x)^2$
    ```

    ```html
    <p>This sentence uses <code>$</code> delimiters to show math inline:
     <math-renderer><math xmlns="http://www.w3.org/1998/Math/MathML">
      <msqrt><mn>3</mn><mi>x</mi><mo>−</mo><mn>1</mn></msqrt>
      <mo>+</mo><mo>(</mo><mn>1</mn><mo>+</mo><mi>x</mi>
      <msup><mo>)</mo><mn>2</mn></msup>
     </math>
    </math-renderer>
    </p>
    ```

    ```markdown
    **The Cauchy-Schwarz Inequality**\
    $$\left( \sum_{k=1}^n a_k b_k \right)^2 \leq \left( \sum_{k=1}^n a_k^2 \right) \left( \sum_{k=1}^n b_k^2 \right)$$
    ```

    ```html
    <p><strong>The Cauchy-Schwarz Inequality</strong><br>
     <math-renderer>
      <math xmlns="http://www.w3.org/1998/Math/MathML">
       <msup>
        <mrow><mo>(</mo>
         <munderover><mo data-mjx-texclass="OP">∑</mo>
          <mrow><mi>k</mi><mo>=</mo><mn>1</mn></mrow><mi>n</mi>
         </munderover>
         <msub><mi>a</mi><mi>k</mi></msub>
         <msub><mi>b</mi><mi>k</mi></msub>
         <mo>)</mo>
        </mrow>
        <mn>2</mn>
       </msup>
       <mo>≤</mo>
       <mrow><mo>(</mo>
        <munderover><mo>∑</mo>
         <mrow><mi>k</mi><mo>=</mo><mn>1</mn></mrow>
         <mi>n</mi>
        </munderover>
        <msubsup><mi>a</mi><mi>k</mi><mn>2</mn></msubsup>
        <mo>)</mo>
       </mrow>
       <mrow><mo>(</mo>
         <munderover><mo>∑</mo>
          <mrow><mi>k</mi><mo>=</mo><mn>1</mn></mrow>
          <mi>n</mi>
         </munderover>
         <msubsup><mi>b</mi><mi>k</mi><mn>2</mn></msubsup>
         <mo>)</mo>
       </mrow>
      </math>
     </math-renderer></p>
    ```
Table Conversions

For more see tables-to-html.md

text
    ```markdown
    | First Header  | Second Header |
    | ------------- | ------------- |
    | Content Cell  | Content Cell  |
    | Content Cell  | Content Cell  |
    ```

    ```html
    <table>
     <thead><tr><th>First Header</th><th>Second Header</th></tr></thead>
     <tbody>
      <tr><td>Content Cell</td><td>Content Cell</td></tr>
      <tr><td>Content Cell</td><td>Content Cell</td></tr>
     </tbody>
    </table>
    ```

    ```markdown
    | Left-aligned | Center-aligned | Right-aligned |
    | :---         |     :---:      |          ---: |
    | git status   | git status     | git status    |
    | git diff     | git diff       | git diff      |
    ```

    ```html
    <table>
      <thead>
       <tr>
        <th align="left">Left-aligned</th>
        <th align="center">Center-aligned</th>
        <th align="right">Right-aligned</th>
       </tr>
      </thead>
      <tbody>
       <tr>
        <td align="left">git status</td>
        <td align="center">git status</td>
        <td align="right">git status</td>
       </tr>
       <tr>
        <td align="left">git diff</td>
        <td align="center">git diff</td>
        <td align="right">git diff</td>
       </tr>
      </tbody>
    </table>
    ```

Working with markedJS/marked

Prerequisites
  • Node.js installed (for CLI or programmatic usage)
  • Install marked globally for CLI: npm install -g marked
  • Or install locally: npm install marked
Quick Conversion Methods

See marked.md Quick Conversion Methods

Step-by-Step Workflows

See marked.md Step-by-Step Workflows

CLI Configuration
Using Config Files

Create ~/.marked.json for persistent options:

json
{
  "gfm": true,
  "breaks": true
}

Or use a custom config:

bash
marked -i input.md -o output.html -c config.json
CLI Options Reference
OptionDescription
-i, --input <file>Input Markdown file
-o, --output <file>Output HTML file
-s, --string <string>Parse string instead of file
-c, --config <file>Use custom config file
--gfmEnable GitHub Flavored Markdown
--breaksConvert newlines to <br>
--helpShow all options
Security Warning

⚠️ Marked does NOT sanitize output HTML. For untrusted input, use a sanitizer:

javascript
import { marked } from 'marked';
import DOMPurify from 'dompurify';

const unsafeHtml = marked.parse(untrustedMarkdown);
const safeHtml = DOMPurify.sanitize(unsafeHtml);

Recommended sanitizers:

Supported Markdown Flavors
FlavorSupport
Original Markdown100%
CommonMark 0.3198%
GitHub Flavored Markdown97%
Troubleshooting
IssueSolution
Special characters at file startStrip zero-width chars: content.replace(/^[\u200B\u200C\u200D\uFEFF]/,"")
Code blocks not highlightingAdd a syntax highlighter like highlight.js
Tables not renderingEnsure gfm: true option is set
Line breaks ignoredSet breaks: true in options
XSS vulnerability concernsUse DOMPurify to sanitize output

Working with pandoc

Prerequisites
  • Pandoc installed (download from https://pandoc.org/installing.html)
  • For PDF output: LaTeX installation (MacTeX on macOS, MiKTeX on Windows, texlive on Linux)
  • Terminal/command prompt access
Quick Conversion Methods
Method 1: CLI Basic Conversion
bash
# Convert markdown to HTML
pandoc input.md -o output.html

# Convert with standalone document (includes header/footer)
pandoc input.md -s -o output.html

# Explicit format specification
pandoc input.md -f markdown -t html -s -o output.html
Method 2: Filter Mode (Interactive)
bash
# Start pandoc as a filter
pandoc

# Type markdown, then Ctrl-D (Linux/macOS) or Ctrl-Z+Enter (Windows)
Hello *pandoc*!
# Output: <p>Hello <em>pandoc</em>!</p>
Method 3: Format Conversion
bash
# HTML to Markdown
pandoc -f html -t markdown input.html -o output.md

# Markdown to LaTeX
pandoc input.md -s -o output.tex

# Markdown to PDF (requires LaTeX)
pandoc input.md -s -o output.pdf

# Markdown to Word
pandoc input.md -s -o output.docx
CLI Configuration
OptionDescription
-f, --from <format>Input format (markdown, html, latex, etc.)
-t, --to <format>Output format (html, latex, pdf, docx, etc.)
-s, --standaloneProduce standalone document with header/footer
-o, --output <file>Output file (inferred from extension)
--mathmlConvert TeX math to MathML
--metadata title="Title"Set document metadata
--tocInclude table of contents
--template <file>Use custom template
--helpShow all options
Security Warning

⚠️ Pandoc processes input faithfully. When converting untrusted markdown:

  • Use --sandbox mode to disable external file access
  • Validate input before processing
  • Sanitize HTML output if displayed in browsers
bash
# Run in sandbox mode for untrusted input
pandoc --sandbox input.md -o output.html
Supported Markdown Flavors
FlavorSupport
Pandoc Markdown100% (native)
CommonMarkFull (use -f commonmark)
GitHub Flavored MarkdownFull (use -f gfm)
MultiMarkdownPartial
Troubleshooting
IssueSolution
PDF generation failsInstall LaTeX (MacTeX, MiKTeX, or texlive)
Encoding issues on WindowsRun chcp 65001 before using pandoc
Missing standalone headersAdd -s flag for complete documents
Math not renderingUse --mathml or --mathjax option
Tables not renderingEnsure proper table syntax with pipes and dashes

Working with gomarkdown/markdown

Prerequisites
  • Go 1.18 or higher installed
  • Install the library: go get github.com/gomarkdown/markdown
  • For CLI tool: go install github.com/gomarkdown/mdtohtml@latest
Quick Conversion Methods
Method 1: Simple Conversion (Go)
go
package main

import (
    "fmt"
    "github.com/gomarkdown/markdown"
)

func main() {
    md := []byte("# Hello World\n\nThis is **bold** text.")
    html := markdown.ToHTML(md, nil, nil)
    fmt.Println(string(html))
}
Method 2: CLI Tool
bash
# Install mdtohtml
go install github.com/gomarkdown/mdtohtml@latest

# Convert file
mdtohtml input.md output.html

# Convert file (output to stdout)
mdtohtml input.md
Method 3: Custom Parser and Renderer
go
package main

import (
    "github.com/gomarkdown/markdown"
    "github.com/gomarkdown/markdown/html"
    "github.com/gomarkdown/markdown/parser"
)

func mdToHTML(md []byte) []byte {
    // Create parser with extensions
    extensions := parser.CommonExtensions | parser.AutoHeadingIDs | parser.NoEmptyLineBeforeBlock
    p := parser.NewWithExtensions(extensions)
    doc := p.Parse(md)

    // Create HTML renderer with extensions
    htmlFlags := html.CommonFlags | html.HrefTargetBlank
    opts := html.RendererOptions{Flags: htmlFlags}
    renderer := html.NewRenderer(opts)

    return markdown.Render(doc, renderer)
}
CLI Configuration

The mdtohtml CLI tool has minimal options:

bash
mdtohtml input-file [output-file]

For advanced configuration, use the Go library programmatically with parser and renderer options:

Parser ExtensionDescription
parser.CommonExtensionsTables, fenced code, autolinks, strikethrough, etc.
parser.AutoHeadingIDsGenerate IDs for headings
parser.NoEmptyLineBeforeBlockNo blank line needed before blocks
parser.MathJaxMathJax support for LaTeX math
HTML FlagDescription
html.CommonFlagsCommon HTML output flags
html.HrefTargetBlankAdd target="_blank" to links
html.CompletePageGenerate complete HTML page
html.UseXHTMLGenerate XHTML output
Security Warning

⚠️ gomarkdown does NOT sanitize output HTML. For untrusted input, use Bluemonday:

go
import (
    "github.com/microcosm-cc/bluemonday"
    "github.com/gomarkdown/markdown"
)

maybeUnsafeHTML := markdown.ToHTML(md, nil, nil)
html := bluemonday.UGCPolicy().SanitizeBytes(maybeUnsafeHTML)

Recommended sanitizer: Bluemonday

Supported Markdown Flavors
FlavorSupport
Original Markdown100%
CommonMarkHigh (with extensions)
GitHub Flavored MarkdownHigh (tables, fenced code, strikethrough)
MathJax/LaTeX MathSupported via extension
MmarkSupported
Troubleshooting
IssueSolution
Windows/Mac newlines not parsedUse parser.NormalizeNewlines(input)
Tables not renderingEnable parser.Tables extension
Code blocks without highlightingIntegrate with syntax highlighter like Chroma
Math not renderingEnable parser.MathJax extension
XSS vulnerabilitiesUse Bluemonday to sanitize output

Working with jekyll

Show full SKILL.md (531 more words)Show less
Prerequisites
  • Ruby version 2.7.0 or higher
  • RubyGems
  • GCC and Make (for native extensions)
  • Install Jekyll and Bundler: gem install jekyll bundler
Quick Conversion Methods
Method 1: Create New Site
bash
# Create a new Jekyll site
jekyll new myblog

# Change to site directory
cd myblog

# Build and serve locally
bundle exec jekyll serve

# Access at http://localhost:4000
Method 2: Build Static Site
bash
# Build site to _site directory
bundle exec jekyll build

# Build with production environment
JEKYLL_ENV=production bundle exec jekyll build
Method 3: Live Reload Development
bash
# Serve with live reload
bundle exec jekyll serve --livereload

# Serve with drafts
bundle exec jekyll serve --drafts
CLI Configuration
CommandDescription
jekyll new <path>Create new Jekyll site
jekyll buildBuild site to _site directory
jekyll serveBuild and serve locally
jekyll cleanRemove generated files
jekyll doctorCheck for configuration issues
Serve OptionsDescription
--livereloadReload browser on changes
--draftsInclude draft posts
--port <port>Set server port (default: 4000)
--host <host>Set server host (default: localhost)
--baseurl <url>Set base URL
Security Warning

⚠️ Jekyll security considerations:

  • Avoid using safe: false in production
  • Use exclude in _config.yml to prevent sensitive files from being published
  • Sanitize user-generated content if accepting external input
  • Keep Jekyll and plugins updated
yaml
# _config.yml security settings
exclude:
  - Gemfile
  - Gemfile.lock
  - node_modules
  - vendor
Supported Markdown Flavors
FlavorSupport
Kramdown (default)100%
CommonMarkVia plugin (jekyll-commonmark)
GitHub Flavored MarkdownVia plugin (jekyll-commonmark-ghpages)
RedCarpetVia plugin (deprecated)

Configure markdown processor in _config.yml:

yaml
markdown: kramdown
kramdown:
  input: GFM
  syntax_highlighter: rouge
Troubleshooting
IssueSolution
Ruby 3.0+ fails to serveRun bundle add webrick
Gem dependency errorsRun bundle install
Slow buildsUse --incremental flag
Liquid syntax errorsCheck for unescaped { in content
Plugin not loadingAdd to _config.yml plugins list

Working with hugo

Prerequisites
Quick Conversion Methods
Method 1: Create New Site
bash
# Create a new Hugo site
hugo new site mysite

# Change to site directory
cd mysite

# Add a theme
git init
git submodule add https://github.com/theNewDynamic/gohugo-theme-ananke themes/ananke
echo "theme = 'ananke'" >> hugo.toml

# Create content
hugo new content posts/my-first-post.md

# Start development server
hugo server -D
Method 2: Build Static Site
bash
# Build site to public directory
hugo

# Build with minification
hugo --minify

# Build for specific environment
hugo --environment production
Method 3: Development Server
bash
# Start server with drafts
hugo server -D

# Start with live reload and bind to all interfaces
hugo server --bind 0.0.0.0 --baseURL http://localhost:1313/

# Start with specific port
hugo server --port 8080
CLI Configuration
CommandDescription
hugo new site <name>Create new Hugo site
hugo new content <path>Create new content file
hugoBuild site to public directory
hugo serverStart development server
hugo mod initInitialize Hugo Modules
Build OptionsDescription
-D, --buildDraftsInclude draft content
-E, --buildExpiredInclude expired content
-F, --buildFutureInclude future-dated content
--minifyMinify output
--gcRun garbage collection after build
-d, --destination <path>Output directory
Server OptionsDescription
--bind <ip>Interface to bind to
-p, --port <port>Port number (default: 1313)
--liveReloadPort <port>Live reload port
--disableLiveReloadDisable live reload
--navigateToChangedNavigate to changed content
Security Warning

⚠️ Hugo security considerations:

  • Configure security policy in hugo.toml for external commands
  • Use --enableGitInfo carefully with public repositories
  • Validate shortcode parameters for user-generated content
toml
# hugo.toml security settings
[security]
  enableInlineShortcodes = false
  [security.exec]
    allow = ['^go$', '^npx$', '^postcss$']
  [security.funcs]
    getenv = ['^HUGO_', '^CI$']
  [security.http]
    methods = ['(?i)GET|POST']
    urls = ['.*']
Supported Markdown Flavors
FlavorSupport
Goldmark (default)100% (CommonMark compliant)
GitHub Flavored MarkdownFull (tables, strikethrough, autolinks)
CommonMark100%
Blackfriday (legacy)Deprecated, not recommended

Configure markdown in hugo.toml:

toml
[markup]
  [markup.goldmark]
    [markup.goldmark.extensions]
      definitionList = true
      footnote = true
      linkify = true
      strikethrough = true
      table = true
      taskList = true
    [markup.goldmark.renderer]
      unsafe = false  # Set true to allow raw HTML
Troubleshooting
IssueSolution
"Page not found" on pathsCheck baseURL in config
Theme not loadingVerify theme in themes/ or Hugo Modules
Slow buildsUse --templateMetrics to identify bottlenecks
Raw HTML not renderingSet unsafe = true in goldmark config
Images not loadingCheck static/ folder structure
Module errorsRun hugo mod tidy

References

Writing and Styling Markdown
markedJS/marked
pandoc
gomarkdown/markdown
jekyll
hugo

© github, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 15 other files (references) in skills/markdown-to-html of github/awesome-copilot.

  • SKILL.md
  • references/basic-markdown-to-html.md
  • references/basic-markdown.md
  • references/code-blocks-to-html.md
  • references/code-blocks.md
  • references/collapsed-sections-to-html.md
  • references/collapsed-sections.md
  • references/gomarkdown.md
  • references/hugo.md
  • references/jekyll.md
  • references/marked.md
  • references/pandoc.md
  • references/tables-to-html.md
  • references/tables.md
  • references/writing-mathematical-expressions-to-html.md
  • references/writing-mathematical-expressions.md

Open the folder on GitHubat commit 727ff2e

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in github/awesome-copilot, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Markdown To HTML next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Markdown To HTML compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Markdown To HTML this skillgithub/awesome-copilot40k1 repos~6.2kAutomated safety check: PassMIT
Markdown PRD to HTML Rendererowainlewis/blueprint412—~1.3kAutomated safety check: PassMIT
Wiki Ado Convertmicrosoft/skills3.1k—~2.3kAutomated safety check: PassMIT
Pandoc DOCX TemplateAchuan-2/pandoc_docx_template1.1k—~1kAutomated safety check: PassNone
Huashu Markdown Publishing Pipelinealchaincyf/huashu-md-html908—~4.8kAutomated safety check: PassMIT
Fix Broken Linkschef/chef-web-docs143—~3.2kAutomated safety check: PassCustom licence

Similar skills

  • Markdown PRD to HTML Renderer

    owainlewis/blueprint

    Converts a complete Markdown PRD or technical design into one verified, static HTML reading page without changing what it says.

    412 GitHub stars~1.3k tokensUpdated yesterday
    Documents & OfficeAuto-check passed
  • Wiki Ado Convert

    microsoft/skills

    Official

    Converts VitePress/GFM wiki markdown to Azure DevOps Wiki-compatible format.

    3.1k GitHub stars~2.3k tokensUpdated today
    DevelopmentAuto-check passed
  • Pandoc DOCX Template

    Achuan-2/pandoc_docx_template

    A skill your agent uses when converting Markdown to Word DOCX or DOCX back to Markdown with Pandoc, especially when the output should use the bundled Chinese Word reference templates, heading…

    1.1k GitHub stars~1k tokensUpdated 3 mo ago
    Documents & OfficeAuto-check passed
  • Huashu Markdown Publishing Pipeline

    alchaincyf/huashu-md-html

    Converts files and web pages into clean Markdown, then turns Markdown into polished HTML, Word, PDF and EPUB using four templates.

    908 GitHub stars~4.8k tokensUpdated 1 mo ago
    Documents & OfficeAuto-check passed
  • Fix Broken Links

    chef/chef-web-docs

    Run linkchecker against a locally served site, a deployed URL, or a local HTML build output, parse the errors, map each broken link back to its Markdown source file, suggest replacement URLs, and…

    143 GitHub stars~3.2k tokensUpdated yesterday
    Documents & OfficeAuto-check passed
  • Pandic Office

    Team-Commonly/commonly

    Convert Markdown to PDF (or DOCX/EPUB/HTML) using the pandoc CLI.

    1.4k GitHub stars~642 tokensUpdated today
    Documents & OfficeAuto-check passed

More from github/awesome-copilot

All 417 skills in this repo
  • Acquire Codebase Knowledge

    github/awesome-copilot

    Official

    Maps an unfamiliar codebase into seven evidence-backed documents in docs/codebase/, using a scan script and templates, for onboarding or architecture write-ups.

    40k GitHub starsUsed in 1 repo~2.3k tokens
    Auto-check passed
  • Azure Architecture Autopilot

    github/awesome-copilot

    Official

    Designs Azure infrastructure from a natural-language description, or diagrams an existing resource group, then refines the design through conversation and deploys it with Bicep.

    40k GitHub starsUsed in 1 repo~1.9k tokens
    Auto-check passed
  • Draw.io Diagram Generator

    github/awesome-copilot

    Official

    Generates, edits and validates draw.io files with correct mxGraph XML, covering flowcharts, architecture, sequence, ER and UML class diagrams.

    40k GitHub starsUsed in 1 repo~4.9k tokens
    Auto-check passed
  • Credit Risk Data Cleaning

    github/awesome-copilot

    Official

    Cleans raw credit data and screens variables before loan modeling, dropping unstable, noisy or redundant features and writing an Excel report of every step.

    40k GitHub starsUsed in 1 repo~1.5k tokens
    Auto-check passed
  • Daily Focus Board

    github/awesome-copilot

    Official

    Builds a warm, browser-based daily focus board the user updates by talking to their agent, with Eisenhower priorities, a brain-dump box and kind not-today carryover.

    40k GitHub stars~3k tokensUpdated today
    Auto-check passed
  • Python Pypi Package Builder

    github/awesome-copilot

    Official

    End-to-end skill for building, testing, linting, versioning, and publishing a production-grade Python library to PyPI.

    40k GitHub starsUsed in 1 repo~4.6k tokens
    Auto-check passed

Works with

Questions about Markdown To HTML

What does Markdown To HTML do?

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…. Markdown To HTML is an agent skill from github/awesome-copilot, published by the product's own GitHub organization.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.

When should I use Markdown To HTML?

Markdown To HTML fits situations like: asked to convert markdown to html; transform md to html; render markdown; generate html from markdown.

How do I install Markdown To HTML in Claude Code?

Run `npx skills add github/awesome-copilot --skill markdown-to-html -a claude-code`. Or copy the skill folder (skills/markdown-to-html in github/awesome-copilot) into .claude/skills/markdown-to-html in your project. Claude Code loads it when a task matches its description.

How do I install Markdown To HTML in Codex?

Run `npx skills add github/awesome-copilot --skill markdown-to-html -a codex`. Or copy the skill folder (skills/markdown-to-html in github/awesome-copilot) into .agents/skills/markdown-to-html in your project. Codex loads it when a task matches its description.

Can I use Markdown To HTML in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add github/awesome-copilot --skill markdown-to-html -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/markdown-to-html, .gemini/skills/markdown-to-html, .github/skills/markdown-to-html and .opencode/skills/markdown-to-html in your project.

What does Markdown To HTML need to run?

Going by SKILL.md and its folder, Markdown To HTML needs the command-line tools its instructions call (pandoc, bundle, go, git, npm and gem). Our summary lists: Node.js.

Does Markdown To HTML access the network?

SKILL.md names 9 domains. In commands or code: github.com and w3.org; the agent is likely to contact these when it follows the instructions. As links in the text: jekyllrb.com, pandoc.org, gohugo.io, marked.js.org, pkg.go.dev, markdownguide.org and blog.kowalczyk.info. This is read from the text; nothing was executed.

Is Markdown To HTML safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Markdown To HTML use?

Markdown To HTML is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Markdown To HTML use?

About 6.2k tokens (SKILL.md is roughly 25k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 23k tokens, read only when the agent opens those files.

What are the alternatives to Markdown To HTML?

Skills that share tags, products or a category with Markdown To HTML: Markdown PRD to HTML Renderer (owainlewis/blueprint, 412 stars), Wiki Ado Convert (microsoft/skills, 3.1k stars), Pandoc DOCX Template (Achuan-2/pandoc_docx_template, 1.1k stars) and Huashu Markdown Publishing Pipeline (alchaincyf/huashu-md-html, 908 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Markdown To HTML?

github (a GitHub organization, an official publisher) maintains it in github/awesome-copilot, which has 39,748 GitHub stars. The repository holds 417 skills in this directory. The repository was last updated on October 7, 2026.

Source: github/awesome-copilot on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.