跳转到内容

Markdown 写作

OpAgent 围绕 Markdown 构建。你写的是纯文本,但编辑器会把非当前编辑区域渲染成更清晰的预览效果。

这意味着你既能保留 Markdown 的可控性,又能用更舒服的方式阅读文档。

先掌握少量语法就够了:

  • # 标题 用来写标题;
  • - 内容 用来写项目列表;
  • 1. 内容 用来写编号列表;
  • > 引用 用来写引用;
  • 代码块用来保存示例或片段;
  • 表格用来对比信息;
  • 图片用来保存视觉材料。

不需要一次记住所有语法。先用最常见的部分,后面按需补充。

当光标位于某一行或某个块时,OpAgent 会保留源码方便编辑。离开后,内容会以预览形式显示。

这对这些内容很有用:

  • 有很多标题的长文;
  • 包含列表、引用和表格的笔记;
  • 保存下来的 AI 对话;
  • 需要反复阅读和修改的文档。

OpAgent 的 Markdown 编辑区不是固定宽度。Markdown 内容区域的左右两侧各有一条隐藏的垂直控制线,用来调整内容显示范围:

  • 左侧控制线:调整 Markdown 内容从哪里开始显示,也就是内容区的左边界。向左拖可以把内容整体向左移,给右侧留下更多空间。
  • 右侧控制线:调整 Markdown 内容区的最大宽度,也就是内容区的右边界。向右拖可以拉宽 Markdown 编辑区,向左拖可以收窄。

平时这两条线会隐藏,避免你写作时误触。需要调整宽表格、长代码行或截图宽内容时,再把它们显示出来并拖动。

控制线不会在文字输入状态下立刻出现。正确操作是:

  1. 打开一个 Markdown 文件。
  2. 如果光标正在正文里闪烁,说明你还处在编辑焦点中。先不要在文字上拖动。
  3. 把鼠标移动到要调整的位置:
    • 调整左边界时,移动到 Markdown 正文左侧的空白边距处;
    • 调整右边界时,移动到 Markdown 正文右侧的空白边距处,靠近当前内容宽度的右边缘。
  4. 在这个空白边距处点击一下并让鼠标停留约 1 秒。这个点击的作用是退出正文编辑焦点并唤出控制线,不会修改 Markdown 内容。
  5. 看到细的垂直高亮线出现后,把鼠标放到线上。鼠标会变成左右拖动的形状。
  6. 按住这条线拖动:
    • 左侧线向左拖,内容起点更靠左;向右拖,内容起点更靠右;
    • 右侧线向右拖,Markdown 内容区变宽;向左拖,内容区变窄。
  7. 松开鼠标后,新的宽度会保留。调整只改变当前编辑器的显示宽度,不会改动 Markdown 文件内容。

如果当前没有正文编辑焦点,也可以不点击,只把鼠标停在左侧或右侧空白边距约 1 秒,等控制线出现后再拖动。

4.2 常见用法:把宽表格完整截下来

Section titled “4.2 常见用法:把宽表格完整截下来”

当 Markdown 表格太宽、普通截图截不全时,可以这样做:

  1. 点击表格外的空白处,让表格退出编辑状态并显示为预览。
  2. 在 Markdown 内容右侧空白边距点击并停留约 1 秒,等右侧控制线出现。
  3. 按住右侧控制线向右拖,把内容区拉宽到表格所有列都可见。
  4. 如果还需要更多空间,在左侧空白边距唤出左侧控制线,把左侧线向左拖。
  5. 表格完整显示后,用系统截图工具截图。
  6. 截图完成后,可以把右侧线拖回左边,恢复适合写作的窄宽度。
  • 截取完整 Markdown 表格:表格列太多时,先把编辑区拉宽,再截图,就能把完整表格放进同一张图里。
  • 查看长代码或长链接:减少自动换行,更容易检查代码、URL、日志和命令。
  • 展示对比内容:产品对比、方案对比、价格表和路线图可以用更接近最终展示的宽度预览。
  • 写作时保持窄宽度:当你只需要专注写正文时,可以把编辑区缩回更适合阅读的宽度。

更多完整流程可以看 截全宽 Markdown 表格

5 使用场景:修改 Markdown 并 review

Section titled “5 使用场景:修改 Markdown 并 review”

很多工具只能在聊天框里生成一段新文本,然后你再复制粘贴回文档。OpAgent 的目标是让 Agent 直接作用在 Markdown 文件上:它可以修改正文,你可以在原文上下文里 review 这次变更,再决定是否保留。

典型流程:

  1. 打开一个 Markdown 文件。
  2. 选中要修改的段落,或在 chat 里描述修改需求。
  3. 让 Agent 直接更新 Markdown 原文。
  4. 在文档里查看修改后的效果和上下文。
  5. 保留满意的部分,不满意就继续改。

这个能力适合用在笔记、帖子、文档、更新日志、README 等需要持续编辑和 review 的 Markdown 内容里。

如果你想看完整 use case,可以打开 审阅 Markdown 修改

Markdown 不只是最终文档格式,也适合用来思考:

  • 先写粗糙想法;
  • 把想法整理成大纲;
  • 让 Agent 帮你优化结构;
  • 自己继续编辑;
  • 在文件顶部保留一个简短摘要,方便以后回看。
  1. 先写原始想法,不急着润色。
  2. 让 Agent 帮你总结或组织结构。
  3. 把有价值部分复制回文档。
  4. 用自己的语气再改一遍。
  5. 在文档中留下最终版本和简短结论。