将Markdown笔记转化成一篇博文

2026-06-08 22:39:00
丁国栋
原创
8
摘要:本文用于将一篇Markdown笔记转换成一篇博文/笔记。

背景:Markdown 是一种很好的内容组织形式,Markdown 的优势在于内容的组织格式是一致的,但它相比 HTML 在表现上还是存在一些差距。因此在我的技术博客网站上,我会使用 HTML 来存储内容。但为了方便,我需要将平时使用 Markdown 记录的一些没有经过整理、排版、润色、检查过的笔记、以及与AI的问答整理成我需要的可以转换成博文形式的笔记,这样我可以再将整理好的 Markdown 文件转换成 HTML 发布出去。

目标:将这一篇 Markdown 记录的没有经过整理、排版、润色、检查过的笔记,或者与AI的一些问答转换成有条理、有逻辑、排版整齐、有用的、容易阅读和维护的、能通过博文形式发布出去的 Markdown 文件,而且它会是一篇好的、有用的技术博文或者有记录性质的笔记、文章等。

思考过程:你需要思考什么是一篇好的有用的技术博文,什么是有记录性质的笔记或者文章,你需要思考一篇技术博文有什么特点,我要求的有记录性质的笔记有什么特点。

其他要求:整理后的 Markdown 文件需要仔细提取出以下内容,

  1. 博文/笔记标题,不需要吸引人,但必须凸显实用性,读过之后知道文章的核心主题;
  2. 在标题后起一个别名,别名的规则是使用英文将中文标题转换成英文标题,且英文单词之间使用连字符'-'连接;
  3. 帮助我将它进行分类,例如它属于哪一类博客类型,当前我博文的类目按照大类分:运维、开发、测试、安全、通用的方法技巧、生活相关、个人思考等,其中这些大类又有子类,例如运维大类中包含网络、Web、Linux、Windows、服务器、性能、灾备、Docker 、Kubernetes、云服务等,开发包括 PHP、Web、DevOps、数据库等。分类至少要分到子类,最好能分为三层:运维/网络/交换机,开发/PHP/性能等,但不强求,实在无法分类的可以只设置一层或者分类为其他。因为我的博文类目会越来越多、越来越完善,所以我不介意有新的分类加入进来,当有更好的分类时可以明确列出来;
  4. 提取关键字,至少3个关键字便于我后面搜索它;
  5. 提取一段文章摘要,用于帮助我和读者快速能获知文章的内容或者观点;
  6. 正文要求:首先是通俗易懂、读起来要顺口,必须符合逻辑,结构清晰,没有错误的内容、错别字等;其次必须是标准的 Markdown 格式,尽可能符合 markdownlint 标准https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md);
  7. 最后我希望你最终生成、整理后的结果只有我需要的Markdown文件的内容,不含有你的思考过程、你与我的沟通细节等等,它要保持纯粹的样子。
  8. 如果你有编辑该文件的权限,请你直接写入文件即可,我会通过阅读你正在转换的 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. 直接写入

  • 如果你有文件编辑权限,直接覆盖原文件
  • 我会通过阅读最终文件来确认任务是否完成

工作流程

  1. 通读原始内容,理解核心主题和要解决的问题
  2. 判断这是一篇技术教程问题排查记录概念科普还是经验总结,据此确定正文的组织结构
  3. 提取标题、别名、分类、关键字、摘要
  4. 重写正文:补全缺失的上下文、删掉无关内容、修正错误、优化表达
  5. 按输出格式组装最终 Markdown
  6. 自查:标题是否实用?分类是否准确?有无错别字?Markdown 语法是否正确?
发表评论
文章分类
联系方式
联系人: 丁国栋
Email: dingguodong@thedf.cc
微信: thedf-cc
GitHub: DingGuodong