Export To Html

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 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 metadata
• Table of contents section (optional)
• Running page headers with logo and document title
• Callout boxes (info, warning, success) for highlighting key information
• Print-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.

# Example parsing
markdown_file = "clients/Circuit/proposal.md"
template_name = "2lines-external"  # default
options = {
    "title": "Project Proposal",
    "client": "Circuit",
    "classification": "Confidential"
}

Step 2: Read Markdown File

from pathlib import Path

# Read the source markdown
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

# Check for YAML frontmatter
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',      # Generates md.toc with table of contents HTML
    'meta',
])

html_content = md.convert(content)

# Extract table of contents (generated by toc extension)
toc_html = md.toc  # Contains <div class="toc">...</div>

Step 5: Build Template Context

Merge frontmatter with command-line options (options take precedence):

from datetime import date

context = {
    **frontmatter,  # From YAML frontmatter
    **options,      # From command arguments
    'content': html_content,
    'toc': toc_html,  # Table of contents
}

# Set defaults
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

# Determine output folder path
if 'output' in options:
    output_dir = Path(options['output'])