Skip to main content
generate-html Export a markdown file to a self-contained HTML folder using Jinja templates. Creates an output folder with HTML, CSS, and image assets from the template. Supports metadata like title, author, client, date via YAML frontmatter or arguments. Triggers: "export to html", "render markdown", "convert to html", "make html", "export document", "render document", "html export".
インストールへ移動 Skills Marketplace コミュニティが作成したAIスキルを発見・探索
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/johncarpenter/circuit-signal --skill generate-htmlコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
Zipをダウンロード ダウンロード中... このリポジトリの他の Skills Export a markdown file to PDF using Jinja templates and WeasyPrint. Renders markdown through the template system and converts to PDF. Supports metadata like title, author, client, date via YAML frontmatter or arguments. Triggers: "export to pdf", "render pdf", "convert to pdf", "make pdf", "export document as pdf", "pdf export", "generate pdf".
Generate focused research experiments from a business goal and available data. Produces 3-5 testable experiments with hypotheses, assumptions, projected outcomes, and ready-to-run signal-discovery prompts. Output saved to workspace/experiments/. Triggers: "research experiments", "generate experiments", "design experiments", "what should we analyze", "research plan", "experiment design".
name generate-html description Export a markdown file to a self-contained HTML folder using Jinja templates. Creates an output folder with HTML, CSS, and image assets from the template. Supports metadata like title, author, client, date via YAML frontmatter or arguments. Triggers: "export to html", "render markdown", "convert to html", "make html", "export document", "render document", "html export".
Export to HTML
Export markdown files to self-contained HTML folders with all assets included.
Usage
/export-to-html <markdown-file> [template] [options]
Arguments
Argument Required Default Description markdown-fileYes - Path to the source markdown file templateNo 2lines-externalTemplate directory name
Options (passed as context)
Option Description --titleDocument title (overrides frontmatter) --subtitleDocument subtitle or one-line description --authorAuthor name (default: "John Carpenter, 2Lines Software") --clientClient name (for external docs) --dateDocument date (default: today, e.g., "February 2026") --versionDocument version (default: "1.0")
--classificationClassification level (default: "Confidential")
--outputOutput folder path (default: workspace/outputs/exports//)
Examples /export-to-html clients/Circuit/proposal.md
/export-to-html research/technical-spike.md --title "Technical Analysis" --client "Acme Corp"
/export-to-html pipeline/rfp-response.md 2lines-external --output exports/rfp
Output Structure The skill creates a self-contained folder with all necessary assets:
<document-name>/
├── index.html # Rendered HTML document
├── style.css # Stylesheet from template
└── logo.svg # Logo and other images from template
Example: For clients/Circuit/proposal.md, output is:
workspace/outputs/exports/proposal/
├── index.html
├── style.css
└── logo.svg
Available Templates Template Directory Purpose 2lines-external _templates/2lines-external/External documents (proposals, reports, deliverables)
Template Structure Each template directory contains:
_templates/<template-name>/
├── base.html # Main template with cover page, TOC, and body structure
├── style.css # Stylesheet (copied to output folder)
└── logo.svg # 2Lines logo (copied to output folder)
The 2lines-external template includes:
Cover page with logo, title, subtitle, client/author metadataTable of contents section (optional)Running page headers with logo and document titleCallout boxes (info, warning, success) for highlighting key informationPrint-optimized styles for PDF generation via browser
Workflow
Step 1: Parse Arguments Extract the markdown file path, template name, and any metadata options from the user's request.
markdown_file = "clients/Circuit/proposal.md"
template_name = "2lines-external"
options = {
"title" : "Project Proposal" ,
"client" : "Circuit" ,
"classification" : "Confidential"
}
Step 2: Read Markdown File from pathlib import Path
md_path = Path(markdown_file)
if not md_path.is_absolute():
md_path = Path.cwd() / md_path
md_content = md_path.read_text()
Step 3: Parse YAML Frontmatter (if present) If the markdown file has YAML frontmatter, extract metadata:
import re
frontmatter = {}
content = md_content
if md_content.startswith('---' ):
match = re.match (r'^---\n(.*?)\n---\n' , md_content, re.DOTALL)
if match :
import yaml
frontmatter = yaml.safe_load(match .group(1 )) or {}
content = md_content[match .end():]
Step 4: Convert Markdown to HTML import markdown
md = markdown.Markdown(extensions=[
'tables' ,
'fenced_code' ,
'codehilite' ,
'toc' ,
'meta' ,
])
html_content = md.convert(content)
toc_html = md.toc
Step 5: Build Template Context Merge frontmatter with command-line options (options take precedence):
from datetime import date
context = {
**frontmatter,
**options,
'content' : html_content,
'toc' : toc_html,
}
if 'title' not in context:
context['title' ] = md_path.stem.replace('-' , ' ' ).title()
if 'date' not in context:
context['date' ] = date.today().isoformat()
Step 6: Create Output Folder import shutil
if 'output' in options:
output_dir = Path(options['output' ])
else :
output_dir = BASE_DIR / "workspace/outputs/exports" / md_path.stem
if not output_dir.is_absolute():
output_dir = BASE_DIR / output_dir
output_dir.mkdir(parents=True , exist_ok=True )
Step 7: Render Template and Copy Assets from jinja2 import Environment, FileSystemLoader
templates_dir = Path("/Users/john/Documents/Workspace/Agents/knowledge-worker-framework/workspace/_fixtures/_templates" )
template_path = templates_dir / template_name
env = Environment(loader=FileSystemLoader(str (template_path)))
template = env.get_template('base.html' )
output_html = template.render(**context)
(output_dir / 'index.html' ).write_text(output_html)
for asset in template_path.glob('*' ):
if asset.suffix in ['.css' , '.svg' , '.png' , '.jpg' , '.jpeg' , '.gif' , '.ico' ]:
shutil.copy2(asset, output_dir / asset.name)
Complete Render Function
"""Render markdown to HTML folder with assets."""
import re
import shutil
from pathlib import Path
from datetime import date
import markdown
from jinja2 import Environment, FileSystemLoader
BASE_DIR = Path("/Users/john/Documents/Workspace/Agents/knowledge-worker-framework" )
TEMPLATES_DIR = BASE_DIR / "workspace/_fixtures/_templates"
ASSET_EXTENSIONS = {'.css' , '.svg' , '.png' , '.jpg' , '.jpeg' , '.gif' , '.ico' , '.woff' , '.woff2' , '.ttf' }
def export_to_html (
markdown_file: str ,
template_name: str = "2lines-external" ,
output_dir: str = None ,
**options
) -> Path:
"""
Export a markdown file to an HTML folder with assets.
Args:
markdown_file: Path to markdown file (relative to BASE_DIR or absolute)
template_name: Template directory name
output_dir: Output folder path (optional)
**options: Metadata options (title, author, client, etc.)
Returns:
Path to the output folder
"""
md_path = Path(markdown_file)
if not md_path.is_absolute():
md_path = BASE_DIR / md_path
if not md_path.exists():
raise FileNotFoundError(f"Markdown file not found: {md_path} " )
md_content = md_path.read_text()
frontmatter = {}
content = md_content
if md_content.startswith('---' ):
match = re.match (r'^---\n(.*?)\n---\n' , md_content, re.DOTALL)
if match :
try :
import yaml
frontmatter = yaml.safe_load(match .group(1 )) or {}
except :
pass
content = md_content[match .end():]
md = markdown.Markdown(extensions=[
'tables' ,
'fenced_code' ,
'codehilite' ,
'toc' ,
])
html_content = md.convert(content)
toc_html = md.toc
context = {
**frontmatter,
**{k: v for k, v in options.items() if v is not None },
'content' : html_content,
'toc' : toc_html,
}
if 'title' not in context:
context['title' ] = md_path.stem.replace('-' , ' ' ).title()
if 'date' not in context:
context['date' ] = date.today().isoformat()
if output_dir:
out_dir = Path(output_dir)
if not out_dir.is_absolute():
out_dir = BASE_DIR / out_dir
else :
out_dir = BASE_DIR / "workspace/outputs/exports" / md_path.stem
out_dir.mkdir(parents=True , exist_ok=True )
template_path = TEMPLATES_DIR / template_name
if not template_path.exists():
raise FileNotFoundError(f"Template not found: {template_path} " )
env = Environment(loader=FileSystemLoader(str (template_path)))
template = env.get_template('base.html' )
output_html = template.render(**context)
(out_dir / 'index.html' ).write_text(output_html)
assets_copied = []
for asset in template_path.iterdir():
if asset.is_file() and asset.suffix.lower() in ASSET_EXTENSIONS:
shutil.copy2(asset, out_dir / asset.name)
assets_copied.append(asset.name)
return out_dir, assets_copied
Execution Steps When the user invokes /export-to-html, execute:
Parse the request - Extract file path, template name, and optionsVerify dependencies - Check that markdown and jinja2 are installedRun the export - Use Bash to execute Python with the render logicReport results - Show the output folder path and list of files created
Error Handling Error Response File not found Report error with suggestions for correct path Template not found List available templates Missing dependencies Show pip install markdown jinja2 pyyaml Render error Show Jinja2 error message
Output Format Export Complete
Source: clients/Circuit/proposal.md
Template: 2lines-external
Output folder: clients/Circuit/proposal/
Files created:
- index.html
- style.css
- logo.svg
Metadata:
Title: Project Proposal
Client: Circuit
Date: 2026-02-12
Classification: Confidential
Open in browser: open clients/Circuit/proposal/index.html
Tips 