Skill/内容写作/Baoyu Format Markdown
内容写作 · 宝玉 27.1k 仓库 Star

Baoyu Format Markdown

让文章结构更清楚

Baoyu Format Markdown 用来整理已经有内容的文章,处理标题层级、列表、重点标记和中英文混排。它先检查读者需要的信息结构,再生成整理后的文件,并通过配套脚本处理间距等细节,适合在写作之后、制作发布稿之前使用。

你需要准备:纯文本或 Markdown 文件与排版偏好

一桉AI 整理 · 2026.10.31 更新 · 查看 GitHub 来源

粘贴到 Codex,它会先检查安装条件,再引导你使用。

Baoyu Format Markdown 能帮你做什么?

  • 梳理文档结构

    检查标题、段落和列表是否反映内容关系,对埋在长段落里的结构信息做合理排版。

  • 统一文字排印

    通过脚本处理中文与英文间距、强调符号和文件头部格式,引号替换可按选项启用。

  • 保留原文并说明改动

    输出独立的整理版本,记录标题、错字和格式调整,避免悄悄覆盖已有稿件。

什么时候适合用?

下面是用法示例,可换成你的材料和目标。

  • 整理技术教程草稿

    示例场景:将已有步骤、命令和说明排成清楚的标题、代码块与列表,保留原有操作含义。

  • 统一公众号前置稿

    示例场景:在转换成公众号排版前,先整理 Markdown 的层级、摘要与中英文间距。

怎么开始使用?

从材料到结果流程示意,非实测结果

原始文本或 Markdown

准备这些材料Markdown 格式整理

纯文本或 Markdown 文件与排版偏好

结构清楚的 Markdown

  1. 01

    识别原文结构

  2. 02

    统一标题与列表

  3. 03

    检查间距并另存

准备什么,会得到什么?

准备的材料
纯文本或 Markdown 文件与排版偏好
交付的结果
  • 整理后的 Markdown 文件。
  • 结构、排印和明显错字的修改记录。

使用前要知道

主要调整格式和明显错字,不能擅自扩写正文或改变论点。脚本需 Bun 或 npx bun;不是公众号直接发布器,本站未运行实测。

常见问题

会把我的文章重新写一遍吗?

不应如此。它可以调整结构和排版,但要保留文风与含义,实质性内容修改需要另行明确。

引号和中英文空格能分别控制吗?

可以。配套脚本提供相应选项,实际执行后应说明启用了哪些处理,而不是默认都已改好。

GitHub 与官方参考

依据项目说明与参考文档整理。页面中的任务与流程示例用于说明用法。

  • Baoyu Format Markdown · Skill 源文件 ↗2026-10-31 核对
来源与使用条件
原始项目
JimLiu/baoyu-skills ↗
作者/维护者
宝玉
Skill 名称
baoyu-format-markdown
Skill 目录
skills/baoyu-format-markdown
仓库 Star
27,105 · 2026-10-31 核对,仅代表仓库关注度。
许可说明
以原项目许可为准
使用条件
格式化脚本需要 Bun;没有 Bun 时可使用 Node.js/npm 提供的 npx bun。项目 README 提供 Codex 项目级安装说明,应保留所选 Skill 的完整目录与脚本。
注意事项
仓库通常采用 MIT,第三方资源以各自许可为准。此 Skill 主要调整排版和明显错字,不能擅自增删或重写正文;来源已核对,未在本站运行实测。
查看安装与使用提示词
请帮我准备并使用 Baoyu Format Markdown Skill,完成下面的任务。请实际执行当前环境允许的安装与检查,不要只返回一份安装教程。

【来源与目标】
原始仓库:https://github.com/JimLiu/baoyu-skills
所选目录:skills/baoyu-format-markdown
参考分支:main
原始目录 frontmatter name:baoyu-format-markdown
安装后的目标调用名:baoyu-format-markdown
来源页面:https://github.com/JimLiu/baoyu-skills/tree/main/skills/baoyu-format-markdown
安装路线核对日期:2026-11-01
当前 SKILL.md(已重新核对名称与资源引用):https://github.com/JimLiu/baoyu-skills/blob/main/skills/baoyu-format-markdown/SKILL.md
上游安装说明:https://github.com/JimLiu/baoyu-skills/blob/main/README.md
Codex 官方 Skill 目录与自动发现规则:https://learn.chatgpt.com/docs/build-skills
格式化脚本依赖清单:https://github.com/JimLiu/baoyu-skills/blob/main/skills/baoyu-format-markdown/scripts/package.json

【先检查环境,再安装】
先识别操作系统、当前 shell、工作目录、同名 Skill 和已有工具;命令须适配实际平台并正确处理带空格的路径。默认安装到当前项目的 .agents/skills;如果没有可用项目目录,再使用用户目录的 .agents/skills。遵循当前 Codex 实际支持的位置;上游 CLI 或插件有专用目录时使用其正式方案。检查现有安装来源与完整性,能复用就复用,不重复注册相同来源、不覆盖用户修改。系统内置与所选第三方来源同名时保留系统版,明确区分来源和实际目录,不能只凭名称认定装过或选对了。
下文 ~/.agents/skills 是用户级路径示例;已选项目范围时,使用项目的 .agents/skills 并保持相同子目录层级。<SKILL_DIR>、<项目根目录> 等占位符须先换成核对过的真实路径再执行。依赖仓库的存放目录与 Codex 发现入口分别处理,不把缓存目录当作已注册入口。
这是上游专用安装路线。按下列说明保留完整仓库布局、关联 Skill 和运行资源;不要退回到只下载 SKILL.md。只有任务需要且上游要求时才安装整包,并说明实际包含的范围。

所选 Skill 的具体安装步骤:
1. 先解析当前项目根目录,以该项目的 .agents/skills 为本次目标;查找已有 baoyu-format-markdown,已有本地修改时保留,避免覆盖或在用户目录重复安装。
2. 使用 Codex 自带 skill-installer 的 install-skill-from-github.py;参数明确为 --repo JimLiu/baoyu-skills --path skills/baoyu-format-markdown --ref main --name baoyu-format-markdown --dest <project>/.agents/skills;<project> 要先解析为当前项目绝对路径。完整保留所选目录,不只下载 SKILL.md。
3. 只读检查 Bun;无 Bun 但有 npx 时,上游允许 npx -y bun。保留 scripts/package.json,并在已安装 Skill 的 scripts 依赖作用域解析 remark/unified/yaml 等包;需要补包时在该作用域按清单准备,不向任意业务项目盲装。
4. 确认目标目录 baoyu-format-markdown/SKILL.md 的 frontmatter name 为 baoyu-format-markdown,并按 resources 保留引用资源和许可文件。
5. Codex 会自动发现项目 .agents/skills;在当前项目查看 Skill 列表。只有未出现时才新建聊天或重载,不把强制重启写成每次安装步骤。

必须保留的资源:
- skills/baoyu-format-markdown/SKILL.md
- skills/baoyu-format-markdown/references
- skills/baoyu-format-markdown/scripts
- scripts/package.json 声明的 remark-cjk-friendly、remark-frontmatter、remark-gfm、remark-parse、remark-stringify、unified、unist-util-visit、yaml 等实际依赖

已知依赖:格式化脚本需要 Bun;没有 Bun 时可使用 Node.js/npm 提供的 npx bun。项目 README 提供 Codex 项目级安装说明,应保留所选 Skill 的完整目录与脚本。
原项目许可:以原项目许可文件为准
特别条件:仓库通常采用 MIT,第三方资源以各自许可为准。此 Skill 主要调整排版和明显错字,不能擅自增删或重写正文;来源已核对,未在本站运行实测。
需要账号、密钥或服务时先检查现有可用连接;让用户在官方授权或本地配置入口完成,不要求把密钥粘贴到聊天。缺少付费服务或不支持的客户端能力时,明确剩余条件与可完成的范围。

【安装后验收】
读取实际安装位置的 SKILL.md,核对真实 name,并检查它引用的脚本、模板、共享文件与工具是否存在。若上游已迁移路径或更名,先核对正式说明再调整;找不到则报告实际错误,不猜路径或宣称成功。
1. 只读检查 scripts/main.ts、quotes.ts、autocorrect.ts 与 scripts/package.json,检查所选 Bun 入口及依赖解析;不对用户源文章运行格式化作安装验证。
2. 只读检查已安装 SKILL.md 的 name、所列引用文件与目录存在,元数据调用名使用 baoyu-format-markdown。
Codex 通常自动发现变更;只有未出现时才引导新建聊天或重载。若本轮尚未出现在可用列表,可在允许的范围内读取已安装的完整文件继续准备任务,同时说明自动识别尚待确认。插件依赖的工具未连接时,不能用读取文件代替连接成功。
分别报告“文件已安装”“Codex 已识别”“任务所需能力已就绪”的实际状态和证据;失败时给出卡住的步骤、错误与下一步,不反复执行相同的失败命令。

【接着引导我使用】
请使用实际可用的 $baoyu-format-markdown;若实际名称发生变化,以刚核对的本地 name 为准。存在不同来源同名项时,明确选择所选来源与实际文件路径,避免调用成系统版或另一版本。对于必须由用户显式调用的 Skill,直接给我下一条可复制的调用语句。
- 提供原文路径与排版程度,先读现有 EXTEND.md,区分纯文本与已有 Markdown;保留事实与原意,把结果另存为原文件名-formatted.md。
- 运行时把 baseDir 解析为实际安装 Skill 路径,脚本对新输出文件做排版;默认空格和强调修复启用,ASCII 引号替换默认关闭,不能把格式化当作自动改写事实。

我想完成的任务:
将我提供的内容整理为清晰的 Markdown:检查标题层级、列表、强调、代码块和中英文间距。遵循我的排版偏好,只调整格式和明显错字,不擅自增删或重写内容。

需要我提供的材料:
纯文本或 Markdown 文件与排版偏好

期望得到:
一份另存的 formatted.md 文件,保留原始文件,并说明需要我确认的格式或文字问题。

先查看我在当前聊天中已经提供的目标与材料,只问缺少的关键内容;没有材料时,告诉我第一步提供什么,可给一个简短示例。条件满足后从一个小任务开始,检查输出,再说明怎样继续使用。示例仅用于演示,不充当我的真实数据;没有执行过的步骤、测试或交付物不要写成已经完成。需要发送、发布或修改外部账号内容时,先让我核对具体对象和内容。

相关 Skill

  • Content Research Writer资料研究与写作
  • Human Writing中文创作与改稿
  • Humanizer自然表达改写

复制到 Codex

浏览器暂未允许直接复制。点击下方文字,按 Ctrl+C(Mac 按 ⌘C)复制,再粘贴到 Codex。

三步开始使用

  1. 找到想做的事,点击「复制提示词」。
  2. 打开 Codex,把提示词粘贴进去并发送。
  3. 按它的提示提供文件或材料,继续完成任务。

按需安装就好,不用一次装完。部分 Skill 需要软件、账号或付费服务,Codex 会先检查使用条件。