doclang — generate Microsoft Word documents from JavaScript.

DocLang is a TypeScript library that builds professional .docx files from semantic components. Describe the structure of a resume — or any document — and DocLang handles typography, spacing, and layout. The output opens in Word, Google Docs, and LibreOffice.

• languageTypeScript — ESM plus a browser bundle
• outputstandard .docx, no HTML or PDF hacks
• peer depdocx, used for packing
• licenseMIT

docx is a peer dependency used to pack the final document.

CDN

Import DocLang without a build step. The browser bundle exposes everything on the global DocLang, with Packer on DocLang.docx.

<!-- index.html -->
<script src="https://unpkg.com/doclang/dist/doclang.min.js"></script>
<script>
  const { Resume, Header, Name } = DocLang;
  const { Packer } = DocLang.docx;
</script>

See README.md for the full CDN setup guide.

Compose a document from components, then hand it to exportFile(). Page margins default to 0.8in top/bottom and 1in left/right.

import {
  Resume, Header, Name, Designation, Contact,
  Summary, Experience, ExperienceItem,
  Skills, Skill, Education, EducationItem,
  exportFile,
} from "doclang";

const resume = Resume(
  Header(
    Name("Jane Smith"),
    Designation("Software Engineer"),
    Contact({
      email: "jane@example.com",
      phone: "+1 555 123 4567",
      github: "github.com/janesmith",
    })
  ),
  Summary("Full-stack engineer with 8+ years of experience."),
  Experience(
    ExperienceItem({
      company: "Tech Corp",
      designation: "Senior Engineer",
      duration: "2021 – Present",
      points: [
        "Led microservices migration",
        "Reduced deploy time by 70%",
      ],
    })
  ),
  Skills(
    Skill("TypeScript"),
    Skill("Node.js")
  )
);

await exportFile(resume, {
  fileName: "jane_smith",
  pdf: true,
});

Run it and a jane_smith.docx (plus .pdf when requested) lands in ./exports.

Every component returns a SectionComponent — a function that produces paragraphs for the document body. Pass any component or a raw string into Resume() or a container. All accept an optional ResumeStyles override as the last argument.

generic

header

profile

experience

education

skills

projects

certifications

languages

awards

references

defaultStyles ships a built-in design. createStyles(overrides?) merges a partial override over it — pass any subset of tokens, leave the rest to the defaults. Sizes are in half-points (24 = 12pt), colors are hex without the #, and spacing is in twips.

import { createStyles, Resume, Header, Name, Experience, ExperienceItem } from "doclang";

const styles = createStyles({
  name: { font: "Georgia", size: 36, bold: true, color: "1A1A2E" },
  sectionHeading: { color: "E94560", bold: true },
  text: { font: "Calibri", size: 20 },
});

const resume = Resume(
  Header(Name("John Doe", styles)),
  Experience(
    ExperienceItem({
      company: "Tech Corp",
      designation: "Engineer",
      duration: "2020 – Present",
      points: ["Built things"],
    }, styles)
  )
);

Style tokens

Each token is a StyleToken with optional font, size, bold, italics, uppercase, color, spacing, alignment, and border fields.

exportFile(document, options?)

The recommended way to save a document. Handles DOCX generation, file writing, and optional PDF conversion — no need to import Packer, fs, or child_process.

Returns { docx: string, pdf?: string } with absolute paths. Throws meaningful errors if any step fails. PDF conversion requires LibreOffice (soffice) on PATH.

const { docx } = await exportFile(resume, {
  outputDir: "./exports",
  fileName: "john_doe",
});

const { docx, pdf } = await exportFile(resume, {
  outputDir: "./exports",
  fileName: "john_doe",
  pdf: true, // requires soffice
});

Utilities

Types

Configuration objects — ContactInfo, PhotoConfig, ExperienceItemConfig, EducationItemConfig, ProjectConfig, CertificationConfig, LanguageConfig, AwardConfig, ReferenceConfig — mirror the component signatures above. The core types:

type SectionComponent = () => Paragraph[];

interface StyleToken {
  font?: string;
  size?: number;     // half-points, 24 = 12pt
  bold?: boolean;
  italics?: boolean;
  uppercase?: boolean;
  color?: string;    // hex, no "#"
  spacing?: { before?: number; after?: number; line?: number };
  alignment?: "left" | "center" | "right";
}

Full signatures for every config object live in REFERENCE.md.