把 PDF 快速转换成 Markdown 的开源工具——这是 Marker 最主要的用途，也是本文讨论的前提。

这篇写给软件工程师：围绕代码阅读与重构、测试与排错和技术文档这几类日常工作，说明它能帮上什么忙、怎么用、哪些地方必须自己把关。

软件工程师的三个高频用法

1. 代码阅读与重构

提示词示例：

先不要改代码。阅读这个模块，画出主要函数的调用关系，指出可以安全重构的部分和风险点，再给出分步重构计划。

把关：先计划后改动。

2. 测试与排错

提示词示例：

这是失败的测试输出和相关代码，请定位原因，给出最小修复，并补一个能防止回归的测试用例。

把关：修复后测试通过。

3. 技术文档

在 Marker 中可以这样提：

根据这段代码和注释生成接口文档：参数、返回值、错误码、调用示例，示例必须能直接运行。

把关：示例代码可运行。

也可以试试：带来源的快速调研

这是「搜索与知识库」类工具的通用任务，软件工程师同样用得上。

请回答【问题】，每个关键结论后标注来源链接；如果不同来源说法不一，请分别列出；最后给出你认为最可靠的来源及原因。

边界与合规

不要把密钥和未开源代码上传到未授权工具，合并前审阅每处改动。

  • 产出由软件工程师本人负责，AI 只是草稿和辅助。
  • 对外内容发布前至少看一遍。
  • 如单位有规定的工具清单，优先在清单内选择；Marker 的同类还有 MinerU、Docling。

一周试用建议

选一个最常做的任务连续用 5 个工作日，记录每次节省的时间和需要修改的地方，再决定是否把 Marker 纳入日常流程。

延伸练习

网页内容抓取

输入：一组需要定期关注的网页。

把这些网页转成 Markdown，去掉导航和广告，只保留正文、发布日期和作者；发布日期缺失时标注「未知」。

检查点：没有臆造发布日期。

检索效果对比

输入：同一批问题和两种检索配置。

用同一批测试问题分别跑关键词检索、向量检索和混合检索，记录前 5 条结果中正确段落的命中情况。

检查点：对比用同一批问题。

构建问答测试集

准备材料：一份产品手册。

根据手册编写 20 个用户可能问的问题及标准答案，标注答案所在章节，用来评估知识库检索效果。

检查点：每个答案都能在手册中找到。

常见问题：中文检索效果差

选择对中文支持好的嵌入模型，并为专有名词建立同义词。

常见问题：表格内容检索不到

换用能保留表格结构的解析工具，或单独把表格转成文本描述。

常见问题：回答过于笼统

要求逐条引用原文，并限定只回答文档中有依据的内容。

概念补充：重排序（Rerank）

对初步检索结果再次打分排序，提升相关性。

概念补充：混合检索

同时使用关键词和向量检索，兼顾精确匹配与语义理解。

适合人群：销售

销售可以用 Marker 处理客户背景调研、跟进邮件与话术等工作。需要注意：客户数据按公司规定处理，报价和承诺以合同为准。

使用提醒

所有示例输出均为示意，不代表真实统计或效果承诺；请以自己的测试结果为准。

文中提示词和示例仅作示意，实际效果取决于你的材料和 Marker 当前版本，重要内容请人工核对后再使用。

延伸阅读