Parser

def parse(template: Template) -> Template:
    """
    Parse a template and extract variables with their metadata.

    Args:
        template: Template with raw content

    Returns:
        Template with parsed variables, name, and about
    """
    content = template.content
    frontmatter = _extract_frontmatter(content)
    sections = _extract_sections(content)

    # Find unique variables (preserve order)
    var_names = list(dict.fromkeys(VARIABLE_PATTERN.findall(content)))

    # Extract info for each variable
    variables = [_extract_variable_info(name, sections, content) for name in var_names]

    return Template(
        name=frontmatter.get("name", template.name),
        about=frontmatter.get("about", ""),
        content=content,
        source=template.source,
        variables=variables,
    )

def render(
    template: Template, values: dict[str, str], remove_comments: bool = True
) -> str:
    """
    Render a template with the given values.

    Args:
        template: Parsed template
        values: Variable values to substitute
        remove_comments: Whether to remove HTML comments

    Returns:
        Rendered markdown string
    """
    content = template.content

    # Temporarily replace comments to avoid Jinja2 parsing issues
    comments: list[str] = []

    def save_comment(match: re.Match) -> str:
        comments.append(match.group(0))
        return f"__COMMENT_{len(comments) - 1}__"

    escaped = COMMENT_PATTERN.sub(save_comment, content)

    # Render with custom delimiters for <variable> syntax
    env = Environment(
        undefined=StrictUndefined,
        autoescape=False,
        keep_trailing_newline=True,
        variable_start_string="<",
        variable_end_string=">",
    )
    rendered = env.from_string(escaped).render(**values)

    # Handle comments
    if remove_comments:
        rendered = re.sub(r"__COMMENT_\d+__\s*\n?", "", rendered)
    else:
        for i, comment in enumerate(comments):
            rendered = rendered.replace(f"__COMMENT_{i}__", comment)

    return rendered