Agent Skills
返回列表
mdutils Markdown 工具箱

mdutils Markdown 工具箱

办公效率 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_ac3c152b/markdowndesignedforopenclaw。

技能介绍

要解决什么问题

Agent 在仓库里改文档时，经常需要按标题读写区块、批量找 .md、或从现有文件里抽出代码块和表格，而不是整篇当纯文本硬改。手写字符串拼接也容易把标题层级和区块边界弄错。

技能如何工作

本技能把 Python mdutils CLI 封装成一组可通过 exec 调用的函数，面向 .md 文件的常见操作：

  • 结构：mdutils_get_headings、mdutils_get_structure 返回 JSON，便于 Agent 先看清文档骨架再决策。
  • 区块编辑：mdutils_read_section / mdutils_replace_section / mdutils_delete_section / mdutils_insert_after 以指定标题为锚点读写内容。
  • 抽取与检索：mdutils_get_code_blocks、mdutils_get_tables、mdutils_find_files 用于从单文件或目录里定位素材。
  • 生成与落盘：mdutils_generate_element 按类型生成标题、表格、列表、链接、代码块等片段；mdutils_write_file 写入完整文件。

典型流程是先 get_structure 或 get_headings 定位章节，再 read_section 取内容，改完后 replace_section 或 insert_after，需要新片段时走 generate_element。

适用边界与注意点

  • 路径与编码：文件路径用系统原生格式；终端需 UTF-8（Windows 可设 PYTHONIOENCODING）。
  • 中文与管道：Windows PowerShell 管道传中文可能乱码，文档建议用 read 子命令 替代管道。
  • 体量：读入为一次性加载，超大 Markdown 宜分批按章节处理。
  • 依赖：Python 3.8+，仅标准库，无第三方包。

使用场景

  • OpenClaw Agent 接到「只改安装章节」时，用 `mdutils_get_structure` 定位标题，再 `replace_section` 替换该段正文。
  • 仓库里几十份 `SKILL.md` 需要盘点时，用 `mdutils_find_files` 枚举 `.md`，再逐文件 `get_headings` 生成目录索引。
  • 发布说明要在「更新日志」标题下追加条目、且保留标题行时，用 `mdutils_insert_after` 插入新版本段落。
  • 要把教程里的示例代码单独汇总时，对目标文件调用 `mdutils_get_code_blocks` 取出全部 fenced code 的 JSON。

适合人员

  • 维护多章节 README 的仓库维护者，希望按标题读写区块而不是整文件覆盖。
  • 为 Agent 编排 `exec` 工具链的集成工程师，需要稳定解析与改写 `.md` 技能说明。
  • 整理技能库或文档站的内容编辑，要从多篇 Markdown 批量提取表格与代码块做校对。
  • 写自动化文档流水线的人，需要用 `mdutils_generate_element` 拼标题、列表、表格再 `write_file` 落盘。