Skip to main content
export-to-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".
Jump to install Skills Marketplace Discover and explore AI skills built by the community.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Show prompt details A direct command skips the review prompt. Inspect the source before running it.
npx skills add https://github.com/johncarpenter/knowledge-base --skill export-to-htmlThe command stays on one line. Scroll horizontally to inspect it before copying.
Prefer a local copy? Download the files currently available to SkillsMP.
Download Zip Downloading... More from this repository 2Lines Software brand voice and style guide. Extends brand-voice-common with company-specific guidelines for all 2Lines content including proposals, documentation, marketing materials, and client communications.
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".
Backup today's Granola meeting notes to local markdown files, organized by client folder. Uses Granola folder metadata to route meetings to appropriate client directories. Run this as part of an evening workflow to archive meeting notes, summaries, and action items. Triggers: "backup meetings", "save today's meetings", "archive meetings", "evening backup", "download meeting notes", "sync meetings", "meeting backup".
name export-to-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: same location as source, named after file)
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:
clients/Circuit/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("/Users/john/Documents/Workspace/2Lines/knowledge-base" ) / 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 = md_path.parent / 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/2Lines/knowledge-base/_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/2Lines/knowledge-base" )
TEMPLATES_DIR = BASE_DIR / "_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 = md_path.parent / 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 Related occupations SOC
Based on SOC occupation classification
