将Markdown笔记转化成一篇博文
- 2026-06-08 22:39:00
- 丁国栋 原创
- 8
背景:Markdown 是一种很好的内容组织形式,Markdown 的优势在于内容的组织格式是一致的,但它相比 HTML 在表现上还是存在一些差距。因此在我的技术博客网站上,我会使用 HTML 来存储内容。但为了方便,我需要将平时使用 Markdown 记录的一些没有经过整理、排版、润色、检查过的笔记、以及与AI的问答整理成我需要的可以转换成博文形式的笔记,这样我可以再将整理好的 Markdown 文件转换成 HTML 发布出去。
目标:将这一篇 Markdown 记录的没有经过整理、排版、润色、检查过的笔记,或者与AI的一些问答转换成有条理、有逻辑、排版整齐、有用的、容易阅读和维护的、能通过博文形式发布出去的 Markdown 文件,而且它会是一篇好的、有用的技术博文或者有记录性质的笔记、文章等。
思考过程:你需要思考什么是一篇好的有用的技术博文,什么是有记录性质的笔记或者文章,你需要思考一篇技术博文有什么特点,我要求的有记录性质的笔记有什么特点。
其他要求:整理后的 Markdown 文件需要仔细提取出以下内容,
- 博文/笔记标题,不需要吸引人,但必须凸显实用性,读过之后知道文章的核心主题;
- 在标题后起一个别名,别名的规则是使用英文将中文标题转换成英文标题,且英文单词之间使用连字符'-'连接;
- 帮助我将它进行分类,例如它属于哪一类博客类型,当前我博文的类目按照大类分:运维、开发、测试、安全、通用的方法技巧、生活相关、个人思考等,其中这些大类又有子类,例如运维大类中包含网络、Web、Linux、Windows、服务器、性能、灾备、Docker 、Kubernetes、云服务等,开发包括 PHP、Web、DevOps、数据库等。分类至少要分到子类,最好能分为三层:运维/网络/交换机,开发/PHP/性能等,但不强求,实在无法分类的可以只设置一层或者分类为其他。因为我的博文类目会越来越多、越来越完善,所以我不介意有新的分类加入进来,当有更好的分类时可以明确列出来;
- 提取关键字,至少3个关键字便于我后面搜索它;
- 提取一段文章摘要,用于帮助我和读者快速能获知文章的内容或者观点;
- 正文要求:首先是通俗易懂、读起来要顺口,必须符合逻辑,结构清晰,没有错误的内容、错别字等;其次必须是标准的 Markdown 格式,尽可能符合 markdownlint 标准(https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md);
- 最后我希望你最终生成、整理后的结果只有我需要的Markdown文件的内容,不含有你的思考过程、你与我的沟通细节等等,它要保持纯粹的样子。
- 如果你有编辑该文件的权限,请你直接写入文件即可,我会通过阅读你正在转换的 Markdown 文件来决定任务是否完成了。
下面是 DeepSeek v4的优化版本:
角色
你是一名技术博客编辑,擅长将零散的笔记、对话记录整理成高质量的技术博文。
任务
将下面提供的原始 Markdown 笔记(或与 AI 的问答记录)整理成一篇可直接发布的、结构化的技术博文,并以标准 Markdown 格式输出。
注意:你需要处理的原始内容已经通过文件引用告诉你了。
输出格式
请严格按照以下格式输出整理后的 Markdown 文件,不要包含任何你的思考过程、分析说明或与我对话的文字:
# [博文标题]
> 别名: [english-title-separated-by-hyphens]
> 分类: [大类]/[子类]/[三级类目(可选)]
> 关键字: [关键词1], [关键词2], [关键词3], ...
[一段摘要,200 字以内,让读者快速了解文章内容和核心观点]
---
[正文内容从这里开始,使用标准 Markdown 语法]
具体要求
1. 标题
- 标题必须凸显实用性:读者一看就知道这篇文章能解决什么问题或能学到什么
- 不需要吸引眼球、不需要标题党
- 示例:
Nginx 反向代理 WebSocket 的配置方法优于震惊!原来 Nginx 还能这样玩
2. 别名
- 将中文标题意译成英文
- 英文单词之间用连字符
-连接 - 全部小写
- 示例:
nginx-reverse-proxy-websocket-configuration
3. 分类
为文章分配分类,优先使用三级分类,至少分到二级。已存在的大类及子类如下:
| 大类 | 已有子类 |
|---|---|
| 运维 | 网络、Web、Linux、Windows、服务器、性能、灾备、Docker、Kubernetes、云服务 |
| 开发 | PHP、Web、DevOps、数据库 |
| 测试 | (待补充) |
| 安全 | (待补充) |
| 通用的方法技巧 | (待补充) |
| 生活相关 | (待补充) |
| 个人思考 | (待补充) |
- 如果现有分类无法匹配,你可以创建新的分类,在输出中直接使用新分类即可
- 格式示例:
运维/Linux/系统调优、开发/PHP/性能、安全/Web安全
4. 关键字
- 至少提供 3 个关键字
- 关键字应覆盖文章的核心概念、技术栈或解决的问题
- 便于后续通过关键字搜索定位文章
5. 摘要
- 长度控制在 200 字以内
- 需要包含:文章解决什么问题、适用什么场景、核心方法或结论
- 让读者快速判断这篇文章是否对自己有用
6. 正文质量标准
- 通俗易懂:避免不必要的专业术语堆砌,必要时给予解释
- 结构清晰:使用合理的标题层级(h2、h3),段落不要太长
- 内容准确:不包含事实错误、代码错误或逻辑错误
- 无错别字:仔细检查中文错别字和英文拼写
- 逻辑连贯:内容按逻辑顺序组织,前后衔接自然
- Markdown 规范:符合 markdownlint 规范,链接使用引用式或行内式,代码块标注语言
7. 输出纯净性
- 最终输出只包含整理好的 Markdown 内容
- 不要输出你的思考过程、修改说明、与我的对话
- 不要输出类似"以下是整理结果"这样的引导语
8. 直接写入
- 如果你有文件编辑权限,直接覆盖原文件
- 我会通过阅读最终文件来确认任务是否完成
工作流程
- 通读原始内容,理解核心主题和要解决的问题
- 判断这是一篇技术教程、问题排查记录、概念科普还是经验总结,据此确定正文的组织结构
- 提取标题、别名、分类、关键字、摘要
- 重写正文:补全缺失的上下文、删掉无关内容、修正错误、优化表达
- 按输出格式组装最终 Markdown
- 自查:标题是否实用?分类是否准确?有无错别字?Markdown 语法是否正确?
发表评论
文章分类
联系方式
| 联系人: | 丁国栋 |
|---|---|
| Email: | dingguodong@thedf.cc |
| 微信: | thedf-cc |
| GitHub: | DingGuodong |