博客投稿格式说明（请以此文件为模板）

本文件仅作为投稿格式说明，请以此为模板撰写文章后提交给编辑团队。

一、文件头部字段说明（必填 & 选填）

每篇文章必须以如下格式开头（即 frontmatter），放在文件最顶部，用 --- 包裹：

---
title: "文章标题，尽量控制在 60 字符以内"
description: "文章摘要，显示在搜索引擎结果和文章卡片中，建议 120~160 字符"
date: 2025-05-08
author: "作者名"
tags: ["标签1", "标签2", "标签3"]
image: https://example.com/cover.jpg   # 封面图 URL（强烈建议填写，尺寸 1200×630）
imageWidth: 1200                        # 封面图宽度，像素（有 image 时必填）
imageHeight: 630                        # 封面图高度，像素（有 image 时必填）
draft: false                            # true = 草稿不发布，false 或不填 = 正常发布
---

字段说明：

字段	是否必填	说明
`title`	✅ 必填	文章标题，同时用于网页 `<title>` 和 OG 标题
`description`	✅ 必填	摘要，搜索引擎摘要 + 列表页卡片描述
`date`	✅ 必填	发布日期，格式 `YYYY-MM-DD`
`author`	选填	作者名，默认 "LeadContact Team"
`tags`	选填	标签数组，用于分类，建议 1~3 个
`image`	⚡ 强烈建议	封面图路径或 URL，用于列表卡片和 OG 图片；建议尺寸 1200×630，不填则自动生成带 Logo 的图片；本地图片写法见下方「图片文件规范」
`imageWidth`	⚡ 强烈建议	封面图宽度（像素），有 `image` 时必须填，建议填 `1200`
`imageHeight`	⚡ 强烈建议	封面图高度（像素），有 `image` 时必须填，建议填 `630`
`draft`	选填	`true` 为草稿，不会在网站展示；默认 `false`

二、Markdown 格式说明

标题

# 一级标题（文章内容中尽量不用，标题已由 frontmatter 中的 title 生成）
## 二级标题
### 三级标题
#### 四级标题

段落与换行

直接写文字即为段落，段落之间空一行。
在行末加两个空格然后回车，可以强制换行（不新开段落）。

文字样式

**加粗文字**
*斜体文字*
~~删除线~~
`行内代码`

效果：加粗文字、斜体文字、~~删除线~~、行内代码

列表

无序列表：

- 第一项
- 第二项
  - 子项（前面加两个空格缩进）
  - 子项
- 第三项

有序列表：

1. 第一步
2. 第二步
3. 第三步

超链接

[链接文字](https://leadcontact.ai)

[带标题的链接](https://leadcontact.ai "LeadContact 官网")

效果：LeadContact 官网

图片

![图片描述（alt 文本）](https://example.com/image.jpg)

![带标题的图片](https://example.com/image.jpg "图片标题")

建议使用外部链接图片（如 CDN 地址），图片 alt 文本有助于 SEO。

控制图片尺寸有两种方式：

方式一：MDC 属性语法（推荐）

![图片描述](https://example.com/image.jpg){style="width:400px"}

方式二：直接写 HTML

<img src="https://example.com/image.jpg" alt="图片描述" width="500" style="border-radius: 8px;" />

"全宽"说明：

不加任何尺寸属性时，图片会撑满文章内容区域的宽度（约 720px），而不是图片原始像素宽度，也不是屏幕宽度。
Mac Retina 屏注意：Retina 屏的 DPR（设备像素比）= 2，浏览器显示 1px 实际用 2 个物理像素渲染。因此一张 800px 的图在 Retina 屏上看起来只有 400px 宽，这是正常现象，不是图片缩小了。建议提供至少 1440px 宽的图片以保证 Retina 屏下清晰全宽显示。

效果（默认全宽，撑满文章区域）：

一台笔记本电脑放在桌上，屏幕上显示代码

效果（指定宽度 400px，CSS 逻辑像素，Retina 屏实际显示 400px）：

一台笔记本电脑放在桌上，屏幕上显示代码

图片带超链接（点击图片跳转）：

[![图片描述](blog/demo/demo-1.jpeg)](https://leadcontact.ai)

效果（点击图片跳转到 LeadContact 官网）：

引用块

> 这是一段引用内容，适合引用名言、重要提示或注意事项。
>
> 引用可以跨多个段落。

效果：

这是一段引用内容，适合引用名言、重要提示或注意事项。

代码块

行内代码用反引号包裹：code

多行代码块用三个反引号，并标注语言：

```javascript
const greeting = 'Hello, World!'
console.log(greeting)
```

效果：

const greeting = 'Hello, World!'
console.log(greeting)

表格

| 列标题1 | 列标题2 | 列标题3 |
|---------|---------|---------|
| 单元格  | 单元格  | 单元格  |
| 内容    | 内容    | 内容    |

对齐方式：

| 左对齐  | 居中    | 右对齐  |
|:--------|:-------:|--------:|
| 内容    | 内容    | 内容    |

效果：

工具	用途	价格
LeadContact	找邮箱	按需付费
LinkedIn	社交网络	免费/付费

分隔线

三个或以上连字符：

---

任务列表

- [x] 已完成的任务
- [ ] 未完成的任务
- [ ] 另一个待办事项

效果：

已完成的任务
未完成的任务

注脚

这里有一个注脚[^1]。

[^1]: 这是注脚的说明内容。

效果：

这里有一个注脚¹，这里还有另一个注脚²。

三、文章结构建议

一篇完整的文章结构参考如下：

---
（frontmatter 字段）
---

（一段简短的开场白，概括文章核心内容，2~3 句话）

## 第一个主要章节

正文内容……

## 第二个主要章节

正文内容……

## 总结

关键要点总结，或号召读者行动（Call to Action）。

四、图片文件规范

文章中用到的图片，请按以下结构组织文件，方便打包后一起发给编辑团队：

你的文章文件名（不含 .md）/
├── your-article-name.md        ← 文章正文
└── blog/
    └── your-article-name/
        ├── cover.jpeg          ← 封面图（frontmatter image 字段引用）
        ├── image-1.jpeg        ← 正文图片
        └── image-2.png

引用方式：

图片路径就是 blog/文章名/文件名，照着下面的格式填写即可：

封面图（frontmatter 里）：

image: blog/your-article-name/cover.jpeg

正文中插入图片：

![图片说明](blog/your-article-name/image-1.jpeg)

提交时打包结构示例：

your-article-name.md
blog/
└── your-article-name/
    ├── cover.jpeg
    └── image-1.jpeg

把 .md 文件和 blog/ 文件夹一起压缩打包发给编辑团队即可。图片命名建议使用英文小写加连字符，如 hero-image.jpeg、step-1-screenshot.png。

五、提交方式

完成后将 .md 文件连同 blog/ 图片文件夹一起压缩打包，发送给 LeadContact 编辑团队。文件命名建议使用英文小写加连字符，例如：

linkedin-cold-outreach-tips-2025.md
b2b-email-finding-guide.md

这是第一个注脚的说明内容，会显示在文章底部。 ↩
注脚支持加粗和链接。 ↩