DCD — Document Compilation Definition

DCD (Document Compilation Description) is a DSL (Domain-Specific Language) and compiler for converting .dcd template files into Microsoft Word (.docx) documents. It uses a simple INI-style section format with HTML-like template tags and JSON data binding.

Install

go install github.com/rachmanzz/dcd@latest

Quick Start

Create report.dcd:

[style]
layout=A4
unit=inch
m=1

[section 0]
name=report
var=info
keys=title, author, date

--- BODY ---
<w:c|b>Test Document</w:c>
<p>Title: <b>{{info.title}}</b></p>
<p>Author: <i>{{info.author}}</i></p>

Run:

dcd report.dcd report.docx
dcd --data report.json report.dcd report.docx

Sections

Section	Description
[section N]	Section with index N
[section:next-page N]	Section break + page break
[style]	Page layout configuration
[style:heading-N]	Heading 1-6 global style
[style:table name]	Named table style
[header] / [footer]	Header and footer

Section Properties

Property	Description
name	Section identifier
var	Variable prefix
keys	Key list
formats	Per-key format

Body Tags

Block Tags

Tag	Description
<h1>–<h6>	Heading
<p>...</p>	Paragraph
<w:c>...</w:c>	Center block
<w:b>...</w:b>	Bold block
<w:i>...</w:i>	Italic block
<w:u>...</w:u>	Underline block
`<w:c	b>...</w:c
`<w:b	i>...</w:b
`<w:b	i
<pb> / <page-break>	Page break
<br>	Line break
<hr>	Horizontal rule

Inline Tags (inside <p>)

Tag	Description
<b>...</b>	Bold
<i>...</i>	Italic
<u>...</u>	Underline
<code>...</code>	Monospace font

Loop Tags

Tag	Description
<loop x from var>...</loop>	Iterate array
<loop:ol x from var>...</loop>	Iterate + ordered list
<loop:ul x from var>...</loop>	Iterate + unordered list
<loop:row x from var>...</loop>	Iterate into table rows

Table Tags

Tag	Description
<table>	Table
<row>	Table row
<col>	Table cell

Other Tags

Tag	Description
<img=path>	Image
<a=url>text</a>	Hyperlink
<ul> / <ol>	List wrapper
<li>	List item

Variables

{{var.key}} — resolved at compile time.

{{info.username}}
{{info.date_field}}
{{x.name}}          ← inside <loop x from var>

Style Configuration

[style]
layout=A4
unit=inch
orientation=portrait
font-family="Times New Roman"
font-size=12
color=#000000
line-height=1.5
m=1

Margin Shorthands

Syntax	Description
m	Uniform margin (all sides)
mx	Horizontal (left & right)
my	Vertical (top & bottom)
mt	Margin top
mb	Margin bottom
ml	Margin left
mr	Margin right
md	Margin default (all sides)

Skills

Detailed references are available in .agents/skills/:

• dcd-documents — DCD DSL reference (sections, tags, styles, etc.)
• dcd-cli — CLI usage and options
• golang-programming — Go library API
• dcd-guide — Project overview and development guide

Library

import "github.com/rachmanzz/dcd/data"
import "github.com/rachmanzz/dcd/parse"
import "github.com/rachmanzz/dcd/render"

doc, _ := parse.Parse("input.dcd")
r := render.NewDocxRenderer()
render.New(doc, data.NewDataSet(nil), r).Run("output.docx")

License

MIT