Markdown to a web page

CodexWith deft, skill installedPassedRead the skillUsed deft2026-11-07

Time

17s

New tokens

7.4k

Total input

77.1k

Output tokens

0.6k

Commands

4

Failed

0

Trace

1. I’ll read the Markdown conversion guidance and the source file, then create `index.html` in the current directory.

2. cat .agents/skills/deft/SKILL.md && printf '\\n---FILES---\\n' && rg --files -g 'commonmark.md' -g 'AGENTS.md' -g 'package.json' -g '*.css' -g '*.html'
   output

   ---
   name: deft
   description: "Use deft instead of writing a script for file jobs: PDF merge/split/compress/watermark, image resize/convert/compress, video and audio trim/convert/compress, spreadsheets, Markdown to PDF/HTML, and YouTube downloads and subtitles."
   ---
   
   # deft
   
   One local command for file jobs. Prefer it over writing Python or shell scripts.
   
   Syntax: `deft <group> <command> [inputs] [-o output] [--options]`
   
   Groups:
   - `pdf`: Merge, split, compress, encrypt, forms, OCR, compare, convert
   - `image`: Resize, crop, convert, compress, filters, montage, OCR
   - `video`: Trim, crop, speed, convert, compress, GIF, frames (ffmpeg)
   - `audio`: Convert, trim, merge, fade, speed, tag, normalize (ffmpeg)
   - `doc`: Word/ODT/RTF: to text, Markdown, HTML, PDF; find and replace
   - `slides`: PowerPoint: extract text, Markdown outline, PDF handout
   - `data`: JSON/YAML/TOML/XML: convert, query with jq syntax, merge, diff
   - `sheet`: Excel/CSV/ODS tables: filter, sort, join, pivot, convert
   - `md`: Markdown to PDF, HTML, Word, EPUB; table of contents
   - `html`: HTML to Markdown, text, Word, PDF; screenshots
   - `epub`: E-books: info, to text, Markdown and PDF
   - `email`: EML files: headers, text, attachments
   - `contact`: VCF address books: to and from CSV
   - `calendar`: ICS calendars: to and from CSV
   - `gps`: GPX and KML tracks: convert, distance and time
   - `youtube`: Info, download, audio, subtitles, thumbnail (yt-dlp)
   - `file`: Any file: hash, duplicates, batch rename, base64, encoding
   - `qr`: Cre
   … 755 more characters

3. deft md --help && printf '\\n---SOURCE---\\n' && cat commonmark.md
   output

   deft md - commands (input -> output)
     from-docx  doc -> md      Convert to Markdown, keeping headings, lists and tables
     from-html  html -> md     Convert to Markdown; scripts and styles are dropped
     from-pdf   pdf -> md      Text as Markdown paragraphs [beta]
     to-docx    md -> docx     Write a Word document with headings, lists, tables, images
     to-epub    md... -> epub  Make an e-book; each top-level heading starts a chapter
     to-html    md -> html     Render to a styled HTML page, or --fragment
     to-pdf     md -> pdf      Typeset Markdown as PDF
     to-pptx    md -> pptx     Make a deck: each heading or --- starts a slide [beta]
     toc        md -> md       Insert a table of contents from the headings
   More: deft md <command> --help
   
   ---SOURCE---
   CommonMark
   ==========
   
   CommonMark is a rationalized version of Markdown syntax,
   with a [spec][the spec] and BSD-licensed reference
   implementations in C and JavaScript.
   
   [Try it now!](https://spec.commonmark.org/dingus/)
   
   [the spec]:  https://spec.commonmark.org/
   
   For more details, see <https://commonmark.org>.
   
   This repository contains the spec itself, along with tools for
   running tests against the spec, and for creating HTML and PDF versions
   of the spec.
   
   The reference implementations live in separate repositories:
   
   - <https://github.com/commonmark/cmark> (C)
   - <https://github.com/commonmark/commonmark.js> (JavaScript)
   
   There is a list of third-party libraries
   in a dozen different languages
   [here](https://github.com/commonmark/Co
   … 6923 more characters

4. The source is a CommonMark project overview. I’m using `deft`’s Markdown-to-HTML converter to produce a standalone styled page.

5. deft md to-html --help
   output

   deft md to-html - Render to a styled HTML page, or --fragment
   Same as: deft convert
   
   Usage: deft md to-html <md>... [-o <html|dir>] [options]
   In: md (each handled separately)   Out: html (default <name>.<ext>)
   
   Options:
     --fragment                   Body only, no <html> page
     --title <text>               Page title (default: first heading)
   Common: -o --force --dry-run --json -j   (deft help common)
   
   Examples:
     deft md to-html notes.md -o notes.html
     deft md to-html notes.md --fragment -o -

6. deft md to-html commonmark.md --title "CommonMark" -o index.html && ls -l index.html && head -c 1000 index.html
   output

   ok md.to-html commonmark.md -> index.html  9KB  0.00s
   -rw-r--r--@ 1 user  staff  8955 Nov  6 17:14 index.html
   <!doctype html>
   <html>
   <head>
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width,initial-scale=1">
   <title>CommonMark</title>
   <style>body{max-width:46rem;margin:2rem auto;padding:0 1rem;font:16px/1.6 -apple-system,'Segoe UI',Roboto,'PingFang SC','Noto Sans CJK SC',sans-serif;color:#1f2328}pre{background:#f6f8fa;padding:.8rem;overflow:auto;border-radius:6px}code{font:.9em ui-monospace,Menlo,Consolas,monospace}table{border-collapse:collapse}th,td{border:1px solid #d0d7de;padding:.3rem .6rem}blockquote{margin:0;padding:0 1rem;color:#59636e;border-left:.25rem solid #d0d7de}img{max-width:100%}</style>
   </head>
   <body>
   <h1>CommonMark</h1>
   <p>CommonMark is a rationalized version of Markdown syntax,
   with a <a href="https://spec.commonmark.org/">spec</a> and BSD-licensed reference
   implementations in C and JavaScript.</p>
   <p><a href="https://spec.commonmark.org/dingus/">Try it now!</a></p>
   <p>For more details, see <a href="https://commonmark.org">https://commonmark.org</a>.</p

7. Created [index.html](index.html) as a standalone HTML page with the Markdown content and embedded styles.

Output

<!doctype html>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>CommonMark</title>
<style>body{max-width:46rem;margin:2rem auto;padding:0 1rem;font:16px/1.6 -apple-system,'Segoe UI',Roboto,'PingFang SC','Noto Sans CJK SC',sans-serif;color:#1f2328}pre{background:#f6f8fa;padding:.8rem;overflow:auto;border-radius:6px}code{font:.9em ui-monospace,Menlo,Consolas,monospace}table{border-collapse:collapse}th,td{border:1px solid #d0d7de;padding:.3rem .6rem}blockquote{margin:0;padding:0 1rem;color:#59636e;border-left:.25rem solid #d0d7de}img{max-width:100%}</style>
</head>
<body>
<h1>CommonMark</h1>
<p>CommonMark is a rationalized version of Markdown syntax,
with a <a href="https://spec.commonmark.org/">spec</a> and BSD-licensed reference
implementations in C and JavaScript.</p>
<p><a href="https://spec.commonmark.org/dingus/">Try it now!</a></p>
<p>For more details, see <a href="https://commonmark.org">https://commonmark.org</a>.</p>
<p>This repository contains the spec itself, along with tools for
running tests against the spec, and for creating HTML and PDF versions
of the spec.</p>
<p>The reference implementations live in separate repositories:</p>
<ul>
<li><a href="https://github.com/commonmark/cmark">https://github.com/commonmark/cmark</a> (C)</li>
<li><a href="https://github.com/commonmark/commonmark.js">https://github.com/commonmark/commonmark.js</a> (JavaScript)</li>
</ul>
<p>There is a list of third-party libraries
in a dozen different languages
<a href="https://github.com/commonmark/CommonMark/wiki/List-of-CommonMark-Implementations">here</a>.</p>
<h2>Running tests against the spec</h2>
<p><a href="https://spec.commonmark.org/">The spec</a> contains over 500 embedded examples which serve as conformance
tests. To run the tests using an executable <code>$PROG</code>:</p>
<pre><code>python3 test/spec_tests.py --program $PROG
</code></pre>
<p>If you want to extract the raw test data from the spec without
actually running the tests, you can do:</p>
<pre><code>python3 test/spec_tests.py --dump-tests
</code></pre>
<p>and you'll get all the tests in JSON format.</p>
<p>JavaScript developers may find it more convenient to use the
<a href="https://www.npmjs.com/package/commonmark-spec"><code>commonmark-spec</code> npm package</a>, which is published from this
repository.  It exports an array <code>tests</code> of JSON objects with
the format</p>
<pre><code class="language-json">{
  "markdown": "Foo\nBar\n---\n",
  "html": "&lt;h2&gt;Foo\nBar&lt;/h2&gt;\n",
  "section": "Setext headings",
  "number": 65
}
</code></pre>
<h2>The spec</h2>
<p>The source of <a href="https://spec.commonmark.org/">the spec</a> is <code>spec.txt</code>.  This is basically a Markdown
file, with code examples written in a shorthand form:</p>
<pre><code>```````````````````````````````` example
Markdown source
.
expected HTML output
````````````````````````````````
</code></pre>
<p>To build an HTML version of the spec, do
… 5948 more characters

CodexWith deft, skill as AGENTS.mdPassed2026-11-05

Time

14s

New tokens

16.1k

Total input

102.7k

Output tokens

0.4k

Commands

5

Failed

0

Trace

1. I’ll inspect `commonmark.md` and convert it into a self-contained `index.html` in the current directory.

2. ls -la && sed -n '1,240p' commonmark.md
   output

   total 24
   drwxr-xr-x@    4 user  staff     128 Nov  4 19:55 .
   drwx------@ 3392 user  staff  108544 Nov  4 19:56 ..
   -rw-r--r--@    1 user  staff    1486 Nov  4 19:55 AGENTS.md
   -rw-r--r--@    1 user  staff    7671 Nov  4 19:32 commonmark.md
   CommonMark
   ==========
   
   CommonMark is a rationalized version of Markdown syntax,
   with a [spec][the spec] and BSD-licensed reference
   implementations in C and JavaScript.
   
   [Try it now!](https://spec.commonmark.org/dingus/)
   
   [the spec]:  https://spec.commonmark.org/
   
   For more details, see <https://commonmark.org>.
   
   This repository contains the spec itself, along with tools for
   running tests against the spec, and for creating HTML and PDF versions
   of the spec.
   
   The reference implementations live in separate repositories:
   
   - <https://github.com/commonmark/cmark> (C)
   - <https://github.com/commonmark/commonmark.js> (JavaScript)
   
   There is a list of third-party libraries
   in a dozen different languages
   [here](https://github.com/commonmark/CommonMark/wiki/List-of-CommonMark-Implementations).
   
   Running tests against the spec
   ------------------------------
   
   [The spec] contains over 500 embedded examples which serve as conformance
   tests. To run the tests using an executable `$PROG`:
   
       python3 test/spec_tests.py --program $PROG
   
   If you want to extract the raw test data from the spec without
   actually running the tests, you can do:
   
       python3 test/spec_tests.py --dump-tests
   
   and you'll get all the tests in JSON format.
   
   JavaScript developers may find it mo
   … 6401 more characters

3. deft md --help
   output

   deft md - commands (input -> output)
     to-html  md -> html  Render to a styled HTML page, or --fragment
     to-pdf   md -> pdf   Typeset a PDF with headings, tables, code, images
   More: deft md <command> --help

4. deft md to-html --help
   output

   deft md to-html - Render to a styled HTML page, or --fragment
   Same as: deft convert
   
   Usage: deft md to-html <md>... [-o <html|dir>] [options]
   In: md (each handled separately)   Out: html (default <name>.<ext>)
   
   Options:
     --fragment                   Body only, no <html> page
     --title <text>               Page title (default: first heading)
   Common: -o --force --dry-run --json -j   (deft help common)
   
   Examples:
     deft md to-html notes.md -o notes.html
     deft md to-html notes.md --fragment -o -

5. deft md to-html commonmark.md -o index.html
   output

   ok md.to-html commonmark.md -> index.html  9KB  0.00s

6. sed -n '1,100p' index.html && rg -n '<link|<script|stylesheet|href=' index.html
   output

   <!doctype html>
   <html>
   <head>
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width,initial-scale=1">
   <title>CommonMark</title>
   <style>body{max-width:46rem;margin:2rem auto;padding:0 1rem;font:16px/1.6 -apple-system,'Segoe UI',Roboto,'PingFang SC','Noto Sans CJK SC',sans-serif;color:#1f2328}pre{background:#f6f8fa;padding:.8rem;overflow:auto;border-radius:6px}code{font:.9em ui-monospace,Menlo,Consolas,monospace}table{border-collapse:collapse}th,td{border:1px solid #d0d7de;padding:.3rem .6rem}blockquote{margin:0;padding:0 1rem;color:#59636e;border-left:.25rem solid #d0d7de}img{max-width:100%}</style>
   </head>
   <body>
   <h1>CommonMark</h1>
   <p>CommonMark is a rationalized version of Markdown syntax,
   with a <a href="https://spec.commonmark.org/">spec</a> and BSD-licensed reference
   implementations in C and JavaScript.</p>
   <p><a href="https://spec.commonmark.org/dingus/">Try it now!</a></p>
   <p>For more details, see <a href="https://commonmark.org">https://commonmark.org</a>.</p>
   <p>This repository contains the spec itself, along with tools for
   running tests against the spec, and for creating HTML and PDF versions
   of the spec.</p>
   <p>The reference implementations live in separate repositories:</p>
   <ul>
   <li><a href="https://github.com/commonmark/cmark">https://github.com/commonmark/cmark</a> (C)</li>
   <li><a href="https://github.com/commonmark/commonmark.js">https://github.com/commonmark/commonmark.js</a> (JavaScript)</li>
   </ul>
   <p>There is a list of third-party librarie
   … 5576 more characters

7. Created [index.html](index.html) from `commonmark.md`. It includes the rendered content, page metadata, and embedded CSS, so it works as a standalone HTML page.

Output

Its files were not kept in this run. The last line of the trace is its own report.

Claude Opus 5.5With deft, skill installedPassedRead the skillUsed deft2026-11-07

Time

11s

New tokens

10.6k

Total input

75.4k

Output tokens

0.7k

Commands

0

Failed

0

Trace

Output

---
name: deft
description: "Use deft first for any simple, direct operation on local files, whatever the type: convert, read, extract, edit, compress, merge, split, compare or inspect. Try it before writing a script or one-liner. If unsure, run deft find; if it says no command does this, use another tool. Not for programming work: to read, write or change source code, skip it."
---

# deft

One local command for file jobs. Prefer it over writing Python or shell scripts.

Syntax: `deft <group> <command> [inputs] [-o output] [--options]`

Groups:
- `pdf`: Merge, split, compress, encrypt, forms, OCR, compare, convert
- `image`: Resize, crop, convert, compress, adjust, montage, OCR
- `video`: Trim, merge, convert, compress, subtitles, GIF, frames (ffmpeg)
- `audio`: Convert, trim, normalize, denoise, cut silence (ffmpeg)
- `doc`: Word/ODT/RTF: to text, Markdown, HTML, PDF; find and replace
- `slides`: PowerPoint: extract text, Markdown outline
- `sheet`: Excel/CSV/ODS tables: SQL query, pivot, merge, split, convert
- `json`: JSON: convert, format, merge, diff, validate
- `toml`: TOML: convert, format, merge, diff, validate
- `xml`: XML: convert, format, merge, diff, validate
- `yaml`: YAML: convert, format, merge, diff, validate
- `md`: Markdown to PDF, HTML, Word, EPUB; table of contents
- `html`: HTML to Markdown, text, Word and PDF
- `epub`: E-books: info, to text, Markdown and PDF
- `gps`: GPX and KML tracks: convert, distance and time
- `qr`: Create QR codes and barcodes; read QR codes

How to use it:
1. Run `deft <group>` to list commands, or `deft find "<what you want>"` to search. If it says `no command does this`, use another tool.
2. Run `deft <group> <command> --help` for options and examples.
3. `deft convert <in> -o <out.ext>` converts between formats by extension.
4. Results are one line starting with `ok`, `partial` or `error`; add `--json` to parse them. Errors include a `hint:` with the fix.

Inputs are never overwritten; pass `--force` or `--in-place` to allow it. Globs and directories work as inputs; several inputs run in parallel.

If `deft` is not installed, ask the user, then follow https://github.com/firstprayer/deft/blob/main/docs/INSTALL.md

<!doctype html>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>CommonMark</title>
<style>body{max-width:46rem;margin:2rem auto;padding:0 1rem;font:16px/1.6 -apple-system,'Segoe UI',Roboto,'PingFang SC','Noto Sans CJK SC',sans-serif;color:#1f2328}pre{background:#f6f8fa;padding:.8rem;overflow:auto;border-radius:6px}code{font:.9em ui-monospace,Menlo,Consolas,monospace}table{border-collapse:collapse}th,td{border:1px solid #d0d7de;padding:.3rem .6rem}blockquote{margin:0;padding:0 1rem;color:#59636e;border-left:.25rem solid #d0d7de}img{max-width:100%}</style>
</head>
<body>
<h1>CommonMark</h1>
<p>CommonMark is a rationalized version of Markdown syntax,
with a <a href="https://spec.commonmark.org/">spec</a> and BSD-licensed reference
implementations in C and JavaScript.</p>
<p><a href="https://spec.commonmark.org/dingus/">Try it now!</a></p>
<p>For more details, see <a href="https://commonmark.org">https://commonmark.org</a>.</p>
<p>This repository contains the spec itself, along with tools for
running tests against the spec, and for creating HTML and PDF versions
of the spec.</p>
<p>The reference implementations live in separate repositories:</p>
<ul>
<li><a href="https://github.com/commonmark/cmark">https://github.com/commonmark/cmark</a> (C)</li>
<li><a href="https://github.com/commonmark/commonmark.js">https://github.com/commonmark/commonmark.js</a> (JavaScript)</li>
</ul>
<p>There is a list of third-party libraries
in a dozen different languages
<a href="https://github.com/commonmark/CommonMark/wiki/List-of-CommonMark-Implementations">here</a>.</p>
<h2>Running tests against the spec</h2>
<p><a href="https://spec.commonmark.org/">The spec</a> contains over 500 embedded examples which serve as conformance
tests. To run the tests using an executable <code>$PROG</code>:</p>
<pre><code>python3 test/spec_tests.py --program $PROG
</code></pre>
<p>If you want to extract the raw test data from the spec without
actually running the tests, you can do:</p>
<pre><code>python3 test/spec_tests.py --dump-tests
</code></pre>
<p>and you'll get all the tests in JSON format.</p>
<p>JavaScript developers may find it more convenient to use the
<a href="https://www.npmjs.com/package/commonmark-spec"><code>commonmark-spec</code> npm package</a>, which is published from this
repository.  It exports an array <code>tests</code> of JSON objects with
the format</p>
<pre><code class="language-json">{
  "markdown": "Foo\nBar\n---\n",
  "html": "&lt;h2&gt;Foo\nBar&lt;/h2&gt;\n",
  "section": "Setext headings",
  "number": 65
}
</code></pre>
<h2>The spec</h2>
<p>The source of <a href="https://spec.commonmark.org/">the spec</a> is <code>spec.txt</code>.  This is basically a Markdown
file, with code examples written in a shorthand form:</p>
<pre><code>```````````````````````````````` example
Markdown source
.
expected HTML output
````````````````````````````````
</code></pre>
<p>To build an HTML version of the spec, do
… 5948 more characters