Use Markdown as the maintainable source for a targeted resume把 Markdown 作为岗位定制简历的可维护源文件
Markdown makes content easy to diff, search, version, and reuse, but it does not make a resume persuasive by itself. Hiring relevance comes from accurate scope, specific outcomes, clear chronology, and a deliberate connection between the job requirements and your verified experience.
Markdown 让内容更容易比较、搜索、版本管理和复用，但它不会自动让简历更有说服力。招聘相关性来自准确职责范围、具体成果、清晰时间线，以及岗位要求与已验证经历之间经过思考的联系。
Know when a Markdown resume workflow is useful了解 Markdown 简历工作流适合什么场景
Career content remains understandable without a specific editor or proprietary binary format.职业内容无需特定编辑器或专有二进制格式也能理解。
Git or another version system can show exactly which achievement, date, or skill changed.Git 或其他版本系统能够显示具体修改了哪个成果、日期或技能。
One source can feed HTML, PDF, Word-compatible, plain-text, or website workflows when templates are controlled.模板受控时，同一源文件可用于 HTML、PDF、Word 兼容、纯文本或网站工作流。
A verified career inventory can support role-specific versions without rewriting history.经过验证的职业资料库可以支持岗位特定版本，而无需重写历史事实。
Markdown is less useful when a required system provides its own form, when collaborators cannot maintain the toolchain, or when the final output relies on complex visual layouts that the converter cannot preserve. Choose the workflow for maintainability and delivery fit, not because plain text is fashionable.
如果招聘系统要求使用自带表单、协作者无法维护工具链，或最终输出依赖转换器无法保留的复杂视觉版式，Markdown 的优势会降低。应根据可维护性和交付适配选择工作流，而不是因为纯文本流行。
Build a clear Markdown resume structure建立清晰的 Markdown 简历结构
Use conventional labels that readers and parsing systems can recognize. A practical order is contact details, targeted summary when useful, skills, professional experience, projects when relevant, education, and selected credentials. Recent or relevant experience usually deserves the most space.
使用读者和解析系统容易识别的常规标签。实用顺序通常是联系方式、必要时的岗位摘要、技能、工作经历、相关项目、教育和精选证书。最近或最相关的经历通常应占据更多篇幅。
# Firstname Lastname
City · email@example.com · portfolio.example
## Professional summary
Two or three lines aligned to the target role.
## Skills
- Data: SQL, Python, dashboard design
- Delivery: requirements, QA, stakeholder review
## Experience
**Role — Organization** | 2024–Present
- Improved a defined process by a verified result.
- Built a repeatable workflow used by a named team.
## Education
**Degree — Institution** | YearDo not copy this wording as personal evidence. Replace every placeholder with facts you can explain. Avoid hidden white text, misleading titles, inflated skills, invented metrics, or confidential employer details. A Markdown resume should make truth easier to maintain, not easier to manufacture.
不要把示例文字当作个人证据。每个占位符都应替换为能够解释的事实。不要使用隐藏白字、误导性职位名称、夸大技能、虚构指标或泄露雇主机密。Markdown 简历应让事实更易维护，而不是更容易制造。
Write achievement bullets that remain credible编写可信且可验证的成果要点
A strong bullet connects action, scope, method, and outcome. Quantification is useful only when the number is accurate, understandable, and attributable. If a reliable percentage is unavailable, quantify scale with time, volume, coverage, frequency, team size, error categories, or delivery responsibility—or describe the outcome precisely without a number.
有力的要点会连接行动、范围、方法和结果。只有在数字准确、易理解且可归因时，量化才有价值。如果没有可靠百分比，可以用时间、数量、覆盖范围、频率、团队规模、错误类别或交付职责说明规模，也可以在没有数字时准确描述结果。
| Weak source薄弱写法 | Questions to answer需要回答的问题 | Evidence-led pattern证据型结构 |
|---|---|---|
| Responsible for reports负责报表 | Which reports, for whom, how often, what changed?哪些报表、服务谁、频率如何、产生什么变化？ | Automated [report scope] for [audience], reducing [verified burden or delay]为[受众]自动化[报表范围]，减少[经验证的负担或延迟] |
| Improved data quality提升数据质量 | What defect, baseline, method, and validation?什么缺陷、基线、方法和验证？ | Introduced [check] across [scope], catching [verified defect category] before [stage]在[范围]引入[检查]，于[阶段]前发现[已验证缺陷类别] |
| Led a project领导项目 | Decision, team, constraints, delivery, outcome?决策、团队、限制、交付和结果是什么？ | Led [team or workstream] to deliver [artifact] under [constraint], enabling [outcome]领导[团队或工作流]在[约束]下交付[产物]，支持[结果] |
Keep a private evidence note for each claim: source, date range, definition, collaborators, and what you personally contributed. Never place confidential proof in the public resume repository.
可为每项成果保留私有证据说明，包括来源、时间范围、定义、协作者和个人贡献。不要把机密证明材料放入公开简历仓库。
Target a job description without keyword stuffing针对岗位说明定制，但不要堆砌关键词
- 1Extract requirements. Separate responsibilities, required skills, preferred skills, domain context, seniority signals, and application instructions.提取要求。区分职责、必需技能、优先技能、领域背景、资历信号和申请说明。
- 2Map evidence. Connect each important requirement to a verified role, project, skill, or credential—or mark it as a genuine gap.映射证据。把重要要求连接到经过验证的经历、项目、技能或证书；没有证据时明确为真实差距。
- 3Prioritize relevance. Move the strongest matching evidence earlier and reduce unrelated detail without distorting chronology.优先相关性。把最强匹配证据提前，减少无关细节，但不要扭曲时间线。
- 4Use exact terms truthfully. Include the employer's terminology when it accurately describes your experience; do not paste a hidden keyword list.真实使用准确术语。只有在确实描述个人经历时，才使用雇主术语；不要粘贴隐藏关键词列表。
- 5Review the whole document. Make sure the summary, skills, bullets, projects, and file name all support the same target.检查整份文档。确保摘要、技能、要点、项目和文件名共同服务于同一目标。
Keyword matching cannot replace qualifications. The goal is to help a recruiter or parser find relevant, truthful evidence quickly. Do not claim familiarity with a tool merely because it appears repeatedly in the job description.
关键词匹配不能替代真实资格。目标是让招聘人员或解析系统快速找到相关、真实的证据。不要因为岗位说明反复出现某个工具，就声称自己具备相关经验。
Version a Markdown resume without leaking private data在不泄露隐私的前提下管理 Markdown 简历版本
Keep a private career inventory as the factual source of truth and generate reviewed application variants from it. Use descriptive names such as resume-data-analyst-2026-08.md instead of “final-final.” Record the target job, source revision, output template, and export date.
把私有职业资料库作为事实来源，再从中生成经过审阅的申请版本。使用 resume-data-analyst-2026-08.md 之类描述性名称，而不是“最终版-最终版”。记录目标岗位、源版本、输出模板和导出日期。
Before publishing a Markdown CV on GitHub or a website, remove home address, personal phone numbers you do not want indexed, private email aliases, references' details, internal project names, customer information, secrets, analytics identifiers, and document metadata. Search repository history as well as the current file; deleting a line from the latest commit does not erase it from earlier history.
在 GitHub 或网站公开 Markdown CV 前，应删除不希望被索引的住址和电话、私有邮箱别名、推荐人信息、内部项目名称、客户信息、密钥、分析标识符和文档元数据。还要搜索仓库历史，而不只是当前文件；从最新提交删除一行并不会自动清除早期历史。
Make the exported resume easier to parse and review让导出的简历更容易解析和审阅
Use a simple single-column reading order, conventional section names, visible text, standard bullets, consistent dates, and ordinary fonts available in the output environment. Avoid placing essential contact information only in headers or footers, and do not rely on icons, charts, skill bars, or decorative columns to communicate critical qualifications.
使用简单单栏阅读顺序、常规章节名称、可见文字、标准项目符号、一致日期和输出环境可用的普通字体。不要只在页眉页脚放置关键联系方式，也不要依赖图标、图表、技能条或装饰性分栏传达重要资格。
File-format advice varies because applicant systems and employer policies differ. The U.S. Department of Labor's 2026 employment workshop notes that PDF preserves formatting while a plain Word document can provide broad ATS compatibility, and instructs applicants to follow the specific upload directions. Review the DOL participant guide and prioritize the employer's stated format.
由于招聘系统和雇主政策不同，文件格式建议也会不同。美国劳工部 2026 年就业培训资料指出，PDF 有利于保持版式，而普通 Word 文档可提供较广的 ATS 兼容性，并要求申请者遵循具体上传说明。可查看劳工部参与者指南，并优先遵守雇主指定格式。
Generic formatting guidance cannot override a specific employer or portal. Read the current job posting, upload instructions, and permitted file types before every submission. No layout can guarantee ATS passage or ranking; parsing is only one part of an employer's selection process.
通用格式建议不能覆盖具体雇主或申请系统的要求。每次提交前都要阅读当前岗位说明、上传指引和允许的文件类型。任何版式都不能保证通过 ATS 或获得排名；解析只是雇主筛选流程的一部分。
Export the Markdown resume to the required file type把 Markdown 简历导出为要求的文件类型
| Output输出 | Strength优势 | Risk风险 | Verification验证方式 |
|---|---|---|---|
| Stable visual layout across viewers跨阅读器版式稳定 | Some parsers may read complex PDFs poorly部分解析器可能无法正确读取复杂 PDF | Select, copy, and extract text; inspect every page选择、复制和提取文字，并逐页检查 | |
| DOCX | Editable and commonly requested可编辑且常被要求 | Fonts and layout can shift by environment字体和版式可能因环境变化 | Open in the recipient's Word environment and check properties在目标 Word 环境打开并检查属性 |
| Plain text | Simple copy, paste, and parsing便于复制、粘贴和解析 | Little visual hierarchy视觉层级有限 | Check order, labels, characters, and links检查顺序、标签、字符和链接 |
| HTML | Accessible web delivery and responsive layout适合可访问网页交付和响应式版式 | May not be accepted by application portals申请系统可能不接受 | Test browser, print stylesheet, metadata, and privacy测试浏览器、打印样式、元数据和隐私 |
Pandoc can convert Markdown to multiple formats. Its official getting-started guide demonstrates HTML, DOCX, and PDF output. Production exports should pin the tool version, template, fonts, and command rather than relying on whichever defaults happen to be installed.
Pandoc 能把 Markdown 转换为多种格式，其官方入门指南演示了 HTML、DOCX 和 PDF 输出。生产导出应固定工具版本、模板、字体和命令，而不是依赖当前环境中偶然存在的默认值。
pandoc resume.md --reference-doc=resume-template.docx -o resume.docx
pandoc resume.md -o resume.pdfConvert the reviewed Markdown resume转换经过审阅的 Markdown 简历
After verifying facts, targeting, privacy, and structure, use the InfiniSynapse Markdown converters to create the requested delivery format. The conversion is a starting point: reopen the exported file, test text extraction, and check every page before applying.完成事实、岗位定制、隐私和结构检查后，可使用 InfiniSynapse Markdown 转换工具生成要求的交付格式。转换只是起点；申请前应重新打开导出文件，测试文字提取并逐页检查。
Convert Markdown to Word将 Markdown 转为 Word Convert Markdown to PDF将 Markdown 转为 PDFVerify the resume before every application每次申请前都要验收简历
- Confirm the target job, employer, location, application deadline, and required file type.确认目标岗位、雇主、地点、申请截止时间和要求的文件类型。
- Check name, email, phone, portfolio, LinkedIn, GitHub, and other links from the exported file.从导出文件检查姓名、邮箱、电话、作品集、LinkedIn、GitHub 和其他链接。
- Verify every employer, role, date, credential, metric, technology, and scope against your records.根据记录核验每个雇主、岗位、日期、证书、指标、技术和职责范围。
- Confirm the strongest relevant evidence appears early and repeated keywords remain natural.确认最强相关证据出现在前部，重复关键词仍然自然。
- Open the PDF or DOCX on another device and inspect wrapping, page breaks, fonts, symbols, and links.在另一台设备打开 PDF 或 DOCX，检查换行、分页、字体、符号和链接。
- Copy the entire document into plain text and inspect reading order, section labels, dates, and characters.把整份文档复制为纯文本，检查阅读顺序、章节标签、日期和字符。
- Remove comments, tracked changes, hidden content, metadata, placeholders, and private evidence notes.删除批注、修订记录、隐藏内容、元数据、占位符和私有证据说明。
- Use a clear file name and archive the exact source revision and output sent.使用清晰文件名，并归档实际发送的源版本和输出文件。
A resume cannot guarantee an interview, an ATS score, or a search ranking. This workflow improves traceability, clarity, and delivery quality; the employer still evaluates fit through its own process.
简历无法保证面试、ATS 分数或搜索排名。该流程能够提升可追溯性、清晰度和交付质量，但雇主仍会按照自己的流程评估匹配度。
Markdown resume FAQMarkdown 简历常见问题
It is useful as a readable, version-controlled source that can feed multiple outputs. The exported design, parsing quality, factual content, and required application format still need separate review.它适合作为可读、可版本控制且能生成多种输出的源文件。导出设计、解析质量、事实内容和申请要求的格式仍需单独审阅。
The source can support a clear single-column structure, but the ATS receives the exported file or pasted text. Follow the employer's instructions and test reading order and extracted text from the actual submission artifact.源文件可以支持清晰单栏结构，但 ATS 接收的是导出文件或粘贴文字。应遵循雇主说明，并测试实际提交文件的阅读顺序和提取文字。
Use the format requested by the employer or portal. PDF usually preserves visual layout; DOCX may be requested for editability or compatibility. Keep both verified outputs when application requirements vary.使用雇主或申请系统指定的格式。PDF 通常更能保持视觉版式，DOCX 可能因可编辑性或兼容性被要求。要求不同时，可以保留两种经过验证的输出。
Only if every current and historical value is safe to publish. Remove unnecessary personal data, confidential work details, references, secrets, and application-specific variants; inspect Git history before making a repository public.只有当前内容和历史内容都适合公开时才应发布。删除不必要个人数据、机密工作细节、推荐人、密钥和申请特定版本，并在公开仓库前检查 Git 历史。
About this guide关于本指南
Quick answer: build a Markdown resume from verified evidence, then tailor it快速答案：先用可验证证据建立 Markdown 简历，再针对岗位定制
Keep one private evidence ledger beside the resume source. For each role or project, capture the date range, context, action, artifact, outcome, measurement method, source that can confirm the statement, confidentiality boundary, and whether the evidence may appear publicly. The ledger is not submitted with the application. It prevents memory drift and makes it easier to write specific bullets without inventing customers, revenue, percentages, rankings, scale, or causal impact.
在简历源文件旁保留一份私密证据台账。每段经历或项目记录时间、背景、行动、产物、结果、测量方法、可确认陈述的来源、保密边界，以及是否允许公开。台账不随申请提交；它用于防止记忆漂移，并帮助写出具体要点，而不是虚构客户、收入、百分比、排名、规模或因果影响。
| Evidence field证据字段 | Resume-safe use简历安全用法 | Do not claim不得声称 |
|---|---|---|
| Owned artifact负责产物 | Name the deliverable and your contribution accurately准确说明产物与个人贡献 | Sole ownership when work was shared把团队成果写成个人独立完成 |
| Measured outcome测量结果 | State the value, period, baseline, and measurement scope写明数值、周期、基线和测量范围 | A precise number with no retained source没有保留来源的精确数字 |
| Sensitive context敏感背景 | Generalize the organization, dataset, or system when permitted在允许时泛化组织、数据集或系统 | Client names, credentials, private links, or regulated data客户名称、凭据、私有链接或受监管数据 |
| Causal language因果表述 | Describe contribution and observed change separately分别描述贡献与观察到的变化 | “Caused” or “guaranteed” without defensible evidence无充分证据时声称“导致”或“保证” |
Use the ledger to choose only evidence relevant to the target role. If an outcome cannot be disclosed or verified, write the responsibility, method, or deliverable honestly rather than replacing it with a fabricated metric. Dates, titles, degrees, certifications, security clearances, publications, and employment status require the same care.
只从台账中选择与目标岗位有关的证据。如果结果不能披露或验证，应诚实描述职责、方法或产物，而不是用虚构指标替代。日期、职位、学历、证书、安全许可、出版物和任职状态同样需要谨慎核对。
Test the exported resume for machine parsing and human review同时测试导出简历的机器解析与人工审阅
No tool can guarantee an ATS score, interview, or hiring outcome. Instead, verify observable properties. Export the reviewed Markdown to the employer’s requested format, reopen the downloaded file, copy its text into a plain-text editor, and confirm that names, headings, employers, dates, bullets, links, and reading order remain intact. Then inspect the same file visually at normal zoom and on a narrow screen. Use a simple one-column fallback when a complex layout damages order or extraction.
任何工具都不能保证 ATS 分数、面试或录用结果。应验证可观察属性：把已审阅 Markdown 导出为雇主要求的格式，重新打开下载文件，将文本复制到纯文本编辑器，确认姓名、标题、雇主、日期、要点、链接和阅读顺序完整；再以正常缩放和窄屏检查视觉呈现。复杂布局破坏顺序或提取时，使用简洁单栏备选。
| Review path审阅路径 | Acceptance evidence验收证据 | Failure response失败处理 |
|---|---|---|
| Text extraction文本提取 | All required sections appear once and in logical order所有必要部分各出现一次且顺序合理 | Remove decorative containers and re-export移除装饰性容器后重新导出 |
| Human scan人工浏览 | Role fit, evidence, dates, and contact details are quickly findable岗位匹配、证据、日期和联系方式易于找到 | Reduce repetition and strengthen hierarchy减少重复并强化层级 |
| Links and privacy链接与隐私 | Public links work and no private data or comments remain公开链接有效且无私密数据或批注残留 | Remove tracking tokens, metadata, and unauthorized details删除跟踪令牌、元数据和未授权细节 |
| Submission route提交路径 | Filename, file type, size, and upload confirmation meet instructions文件名、类型、大小和上传确认符合要求 | Follow the employer’s stated format, not a generic preference遵循雇主明确格式而非通用偏好 |
Ask another person to compare the job description, evidence ledger, resume source, and exported file. Their task is to find unsupported claims, missing qualifications, ambiguous dates, keyword stuffing, and conversion damage. Keep a clean application-specific version and a record of what was submitted; do not overwrite the master evidence ledger with shortened marketing language.
请另一位审阅者对照岗位说明、证据台账、简历源文件与导出文件，查找无依据陈述、遗漏资格、含糊日期、关键词堆砌和转换损坏。保留干净的岗位版本和提交记录，不要用缩短后的营销语言覆盖主证据台账。
Official sources and references for resume preparation简历准备的官方来源与参考资料
Use the U.S. Department of Labor participant guide and Pandoc getting-started guide already linked in this page. For additional role-neutral resume guidance, review the U.S. Department of Labor-sponsored CareerOneStop resume resources. These sources support preparation and conversion practices; employer requirements always control the actual submission.
请使用页面已链接的美国劳工部参与者指南和 Pandoc 入门指南，并参考美国劳工部支持的 CareerOneStop 简历资源。这些来源支持准备与转换方法，实际提交仍以雇主要求为准。