ARTICLE DETAIL

建站实战干货

来自一线的建站与推广经验沉淀,每一条都经过真实交付验证。

kordoc公文生成引擎:从Markdown一键生成HWPX,9种preset·表格·公式·图表全解

2026/10/4 21:38:00 拓冰建站 浏览量
kordoc公文生成引擎:从Markdown一键生成HWPX,9种preset·表格·公式·图表全解 kordoc公文生成引擎从Markdown一键生成HWPX9种preset·表格·公式·图表全解【免费下载链接】kordoc모두 파싱해버리겠다 — HWP·HWPX·PDF·Office 문서를 Markdown으로. 양식 자동 채우기와 신구대조를 갖춘 CLI·MCP 서버 | Convert Korean documents (HWP, HWPX, PDF, Office) to Markdown — CLI and MCP server with form filling and diff项目地址: https://gitcode.com/gh_mirrors/ko/kordockordoc韩语口号모두 파싱해버리겠다——全部给我解析掉是一个免费的开源韩国文档处理工具核心能力是双向的把 HWP·HWPX·PDF·Office 文档转成 Markdown也能从 Markdown 一键生成公文级 HWPX 文件。它的公文生成引擎内置 9 种公文 preset、政府公文表格样式、原生公式与 8 类图表一条命令就能产出可直接用 한글(Hancom Office) 打开的规范公文。为什么需要公文生成引擎韩国公文공문서有严格的格式规范法定 8 级项目符号1.가.1)가)(1)(가)①㉮、2 单位缩进与悬挂缩进、机关名/标题/결문表骨架、正文 15pt 明体……手工排版费时且容易踩雷。kordoc 的做法是你只管写 Markdown 的内容结构标题、列表、表格、公式、图表引擎自动完成项目符号按深度自动映射到法定 8 级编号计数器逐层重置缩进、悬挂缩进、行距、页边距按 preset 实测规范自动套用结尾自动补끝.、두문표文首表、결문표文末表、审批栏等骨架生成逻辑的规格完整记录在 docs/gongmunseo-engine-spec.md所有数值均来自真实 한컴 公文的逆向实测而非猜测。9种preset一份代码库覆盖全部公文场景生成入口是 src/hwpx/generator.ts 的markdownToHwpxpreset 定义在 src/hwpx/gongmun.ts。9 种公文类型一览preset韩文名适用场景自动附加的元素official기안문默认内部提案·请示두문표·결문表、끝.、审批栏report보고서业务报告书Ⅰ. 章条带、□○- 项目体系、摘要框plan계획서计划书同报告书5W2H 骨架notice통지·공고通知·公告公告编号、发送者署名minutes회의록会议记录9 要素表、议程编号gaejosik개조식政府标准条列式报告封面页、目录、罗马数字章头、页码press보도자료新闻稿头部框、副题、联系方式表ministry업무보고中央部处业务报告章节色带、❶任务条、成果摘要框、别件bangchim서울방침首尔市方针书标题表、蓝色副题、[Ⅰ] 章框、 사전 검토 점검표如何选择preset日常提案/请示→ 直接用默认的official기안문结尾的끝.和 결문 表自动加上政府标准报告→gaejosik第一个 h1 自动变封面蓝色装饰条标题日期机构名h2 自动生成罗马数字章头和目录页码显示为- 1 -且封面/目录不计数部处级业务报告→ministry按财经部实物的色带章节、关键词蓝色高亮、 ▪ …自动变成果摘要框不确定选哪个→ 先用默认official跑一遍看 CLI 的 warning 提示切换表格、公式、图表公文里的三大块级元素表格写GFM出政府公文样式Markdown 里写标准管道表格GFM引擎按政府公文惯例自动排版表头行#E6E6E6灰底 加粗 居中跨页自动重复表头列宽按内容实测宽度比例分配而不是简单均分내용类长列自动左对齐、短列居中单元格内容超长时字号自动从 12 → 11 → 10pt 递降表尾双重细线、外框 0.4mm 等边框层级都按实测公文复刻实现见 src/hwpx/gen-table.ts。更妙的是kordoc profile命令把任意一份机构既有 HWPX 的表格样式边框·底色·列宽·字体提取成 JSON再用--profile注入生成——用你单位的老样子生成新文档。公式LaTeX子集 → HWPX原生对象$$a^2 b^2 c^2$$双美元符号包裹的 display math 会转成 HWPX原生hp:equation公式对象不是图片、不是文本支持\frac·\sqrt·上下标·希腊字母·积分/极限·矩阵等 LaTeX-like 子集。生成逻辑在 src/hwpx/equation-generate.ts——在 한글 里打开可以直接编辑公式。图表一段fence块生成8类图表chart type: column # column|bar|line|area|pie|doughnut|scatter|radar_stacked/3d 变体 cat: 1분기, 2분기, 3분기 예산: 10, 20, 30 집행: 5, 15, 25引擎会把这段 fence 组装成 OOXML DrawingML 的 Chart/chartN.xml chartSpace 部件并挂到 manifest正文以 hp:chart 引用——也就是**真正的可编辑图表对象**共 20 种类型变体含堆积柱状、环形、3D 等还支持 colors 指定系列色、size 指定毫米尺寸。解析与装配逻辑见 [src/hwpx/chart-gen.ts](https://link.gitcode.com/i/3e727a84be22cbe9d94858da0309e8b1)。 ## 三种调用方式CLI · API · MCP ### 一键安装与CLI步骤 bash npx kordoc generate 보고서.md -o 보고서.hwpx --preset gaejosik --org 기관명常用生成选项详见 docs/usage.md--preset上述 9 种公文 preset也接受韩文名如--preset 개조식--approval 담당,팀장,과장右上角审批栏--toc/--cover强制目录页 / 封面页--fonts body나눔명조,heading나눔고딕、--pt、--line-spacing字体与排版微调--image-dir ./img把 Markdown 里![](x.png)的图片实际嵌入文档作为库npm 包import { markdownToHwpx } from kordoc await markdownToHwpx(# 제목\n\n본문\n\n| 이름 | 직급 |\n| --- | --- |\n| 홍길동 | 과장 |, { gongmun: { preset: report, approval: [담당, 팀장, 과장] } })作为MCP服务器kordoc-mcp提供generate_document等 17 个工具工具定义在 src/mcp/tools-generate.ts支持Markdown(表·式·차트) → HWPX, 公文 preset——接上 Claude 之类的 Agent就能对话式产出公文。生成前自检19条公文规范lint生成之外还有kordoc lint对 Markdown 原稿检查 19 条公文表记规范金额/日期写法、条列文体等开--munche还会对报告书·计划书做条列文体检查叙述体结尾、应然表达、项目过长等。规范核心在 src/hwpx/munche-lint.ts。快速上手清单npm install -g kordoc或直接用npx kordoc写一份 Markdownh1 标题 → h2 章节 → 列表做项目 → 管道表做数据kordoc generate 原稿.md -o 成品.hwpx --preset 개조식 --org 기관명用 한글 打开检查需要贴合单位风格时补--profile 机构서식.profile.json不满意排版--pt、--line-spacing、--fonts三个旋钮足够微调完整命令参考docs/usage.md生成引擎设计全解docs/gongmunseo-engine-spec.mdv5 生成管线outline → scheme → section XML → 骨架表见 src/hwpx/gen-gongmun.ts。小结kordoc 的公文生成引擎把韩国公文排版这件重活变成了 preset 结构化的 Markdown——9 种公文类型、原生表格/公式/图表一条命令全搞定。【免费下载链接】kordoc모두 파싱해버리겠다 — HWP·HWPX·PDF·Office 문서를 Markdown으로. 양식 자동 채우기와 신구대조를 갖춘 CLI·MCP 서버 | Convert Korean documents (HWP, HWPX, PDF, Office) to Markdown — CLI and MCP server with form filling and diff项目地址: https://gitcode.com/gh_mirrors/ko/kordoc创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考