Format for describing electronic circuits in markdown. Use when designing, documenting, or generating circuit schematics with AI assistance. Embeds structured circuit definitions (components, nets, connections) within prose explanations. Supports export to KiCad netlist format. Use for: (1) AI-assisted circuit design, (2) Documenting circuit topology with rationale, (3) Generating netlists for PCB tools, (4) Collaborative circuit reviews.
A markdown format for describing circuits that is both human-readable and machine-parseable.
Circuit definitions are embedded in prose using a distinctive [bracket] syntax. The prose captures design rationale; the structured elements capture topology.
The MCU needs a 3.3V supply. We use an LM1117 for regulation.
[VIN]: net
[3V3]: net
[GND]: net
[U1]: lm1117(3.3V)
[VIN --- U1.VIN]
[U1.VOUT --- 3V3]
[U1.GND --- GND]
Input and output capacitors per datasheet:
[VIN --- 10µF --- GND]
[3V3 --- 10µF --- GND]
Optional YAML frontmatter, then markdown with embedded circuit elements:
---