Markdown 写作
1 自然写作
Section titled “1 自然写作”OpAgent 围绕 Markdown 构建。你写的是纯文本,但编辑器会把非当前编辑区域渲染成更清晰的预览效果。
这意味着你既能保留 Markdown 的可控性,又能用更舒服的方式阅读文档。
2 常用 Markdown 基础
Section titled “2 常用 Markdown 基础”先掌握少量语法就够了:
# 标题用来写标题;- 内容用来写项目列表;1. 内容用来写编号列表;> 引用用来写引用;- 代码块用来保存示例或片段;
- 表格用来对比信息;
- 图片用来保存视觉材料。
不需要一次记住所有语法。先用最常见的部分,后面按需补充。
3 Live preview 的编辑体验
Section titled “3 Live preview 的编辑体验”当光标位于某一行或某个块时,OpAgent 会保留源码方便编辑。离开后,内容会以预览形式显示。
这对这些内容很有用:
- 有很多标题的长文;
- 包含列表、引用和表格的笔记;
- 保存下来的 AI 对话;
- 需要反复阅读和修改的文档。
4 可调整宽度的 Markdown 编辑区
Section titled “4 可调整宽度的 Markdown 编辑区”OpAgent 的 Markdown 编辑区不是固定宽度。Markdown 内容区域的左右两侧各有一条隐藏的垂直控制线,用来调整内容显示范围:
- 左侧控制线:调整 Markdown 内容从哪里开始显示,也就是内容区的左边界。向左拖可以把内容整体向左移,给右侧留下更多空间。
- 右侧控制线:调整 Markdown 内容区的最大宽度,也就是内容区的右边界。向右拖可以拉宽 Markdown 编辑区,向左拖可以收窄。
平时这两条线会隐藏,避免你写作时误触。需要调整宽表格、长代码行或截图宽内容时,再把它们显示出来并拖动。
4.1 怎么显示这两条控制线
Section titled “4.1 怎么显示这两条控制线”控制线不会在文字输入状态下立刻出现。正确操作是:
- 打开一个 Markdown 文件。
- 如果光标正在正文里闪烁,说明你还处在编辑焦点中。先不要在文字上拖动。
- 把鼠标移动到要调整的位置:
- 调整左边界时,移动到 Markdown 正文左侧的空白边距处;
- 调整右边界时,移动到 Markdown 正文右侧的空白边距处,靠近当前内容宽度的右边缘。
- 在这个空白边距处点击一下并让鼠标停留约 1 秒。这个点击的作用是退出正文编辑焦点并唤出控制线,不会修改 Markdown 内容。
- 看到细的垂直高亮线出现后,把鼠标放到线上。鼠标会变成左右拖动的形状。
- 按住这条线拖动:
- 左侧线向左拖,内容起点更靠左;向右拖,内容起点更靠右;
- 右侧线向右拖,Markdown 内容区变宽;向左拖,内容区变窄。
- 松开鼠标后,新的宽度会保留。调整只改变当前编辑器的显示宽度,不会改动 Markdown 文件内容。
如果当前没有正文编辑焦点,也可以不点击,只把鼠标停在左侧或右侧空白边距约 1 秒,等控制线出现后再拖动。
4.2 常见用法:把宽表格完整截下来
Section titled “4.2 常见用法:把宽表格完整截下来”当 Markdown 表格太宽、普通截图截不全时,可以这样做:
- 点击表格外的空白处,让表格退出编辑状态并显示为预览。
- 在 Markdown 内容右侧空白边距点击并停留约 1 秒,等右侧控制线出现。
- 按住右侧控制线向右拖,把内容区拉宽到表格所有列都可见。
- 如果还需要更多空间,在左侧空白边距唤出左侧控制线,把左侧线向左拖。
- 表格完整显示后,用系统截图工具截图。
- 截图完成后,可以把右侧线拖回左边,恢复适合写作的窄宽度。
4.3 什么时候使用宽编辑区
Section titled “4.3 什么时候使用宽编辑区”- 截取完整 Markdown 表格:表格列太多时,先把编辑区拉宽,再截图,就能把完整表格放进同一张图里。
- 查看长代码或长链接:减少自动换行,更容易检查代码、URL、日志和命令。
- 展示对比内容:产品对比、方案对比、价格表和路线图可以用更接近最终展示的宽度预览。
- 写作时保持窄宽度:当你只需要专注写正文时,可以把编辑区缩回更适合阅读的宽度。
更多完整流程可以看 截全宽 Markdown 表格。
5 使用场景:修改 Markdown 并 review
Section titled “5 使用场景:修改 Markdown 并 review”很多工具只能在聊天框里生成一段新文本,然后你再复制粘贴回文档。OpAgent 的目标是让 Agent 直接作用在 Markdown 文件上:它可以修改正文,你可以在原文上下文里 review 这次变更,再决定是否保留。
典型流程:
- 打开一个 Markdown 文件。
- 选中要修改的段落,或在 chat 里描述修改需求。
- 让 Agent 直接更新 Markdown 原文。
- 在文档里查看修改后的效果和上下文。
- 保留满意的部分,不满意就继续改。
这个能力适合用在笔记、帖子、文档、更新日志、README 等需要持续编辑和 review 的 Markdown 内容里。
如果你想看完整 use case,可以打开 审阅 Markdown 修改。
6 把 Markdown 当成思考工具
Section titled “6 把 Markdown 当成思考工具”Markdown 不只是最终文档格式,也适合用来思考:
- 先写粗糙想法;
- 把想法整理成大纲;
- 让 Agent 帮你优化结构;
- 自己继续编辑;
- 在文件顶部保留一个简短摘要,方便以后回看。
7 推荐写作流程
Section titled “7 推荐写作流程”- 先写原始想法,不急着润色。
- 让 Agent 帮你总结或组织结构。
- 把有价值部分复制回文档。
- 用自己的语气再改一遍。
- 在文档中留下最终版本和简短结论。