libdoc

libdoc——文档构建与托管工具。build 函数可利用 Mustache 模板，将 Markdown 文档生成静态站点；serve 函数则提供本地开发服务器。parseFrontMatter 能从 Markdown 文件中提取 YAML 元数据。适用于生成文档网站，以及在本地便捷地托管与展示文档。

name: libdoc description: > libdoc - Documentation build and serve tools. build function generates static sites from Markdown with Mustache templates. serve function provides local development server. parseFrontMatter extracts YAML metadata from markdown files. Use for generating documentation websites and serving docs locally.

libdoc Skill

When to Use

•Building static documentation sites from markdown
•Serving documentation locally during development
•Parsing YAML front matter from markdown files
•Generating HTML from markdown with templates

Key Concepts

build: Processes markdown files with front matter, applies Mustache templates, and outputs static HTML.

serve: Local development server with live reload for documentation preview.

parseFrontMatter: Extracts YAML metadata from markdown file headers.

Usage Patterns

Pattern 1: Build documentation

javascript

import { build } from "@copilot-ld/libdoc";

await build({
  srcDir: "docs",
  outDir: "public",
  template: "template.html.mustache",
});

Pattern 2: Parse front matter

javascript

import { parseFrontMatter } from "@copilot-ld/libdoc";

const { data, content } = parseFrontMatter(markdownContent);
console.log(data.title); // From YAML header

Integration

Used by make docs to build the documentation site. Output served via static file hosting.