编辑器

---

编辑器类提供了在编辑模式下读取和操作活动 Markdown 文档的操作。

如果要在命令中访问编辑器，请使用 editorCallback。

如果您想在其他地方使用编辑器，可以从活动视图中访问它：

const view = this.app.workspace.getActiveViewOfType(MarkdownView);

// Make sure the user is editing a Markdown file.
if (view) {
	const cursor = view.editor.getCursor();

	// ...
}

[!tip]

Obsidian使用 CodeMirror (CM) 作为底层的文本编辑器。并且将CodeMirror作为API的一部分开放出来。 Editor 作为一个抽象层，在 CM6 和 CM5（传统编辑器，仅在桌面上可用）间进行了桥接。通过使用 Editor 而不是直接访问 CodeMirror 实例，可以确保您的插件在两个平台上都能运行。

在光标位置插入文本

replaceRange() 方法会替换两个光标位置之间的文本。如果只给它一个位置，它会在该位置插入新文本。

以下例子将会在光标位置插入今天的日期：

import { Editor, moment, Plugin } from "obsidian";

export default class ExamplePlugin extends Plugin {
  async onload() {
    this.addCommand({
      id: "insert-todays-date",
      name: "Insert today's date",
      editorCallback: (editor: Editor) => {
        editor.replaceRange(
          moment().format("YYYY-MM-DD"),
          editor.getCursor()
        );
      },
    });
  }
}

替换当前选择

如果要修改选中的文本，请使用  replaceSelection() 将当前选中的文本替换为新文本。

下面的例子将读取当前的选区并将其转换为大写：

import { Editor, Plugin } from "obsidian";

export default class ExamplePlugin extends Plugin {
  async onload() {
    this.addCommand({
      id: "convert-to-uppercase",
      name: "Convert to uppercase",
      editorCallback: (editor: Editor) => {
        const selection = editor.getSelection();
        editor.replaceSelection(selection.toUpperCase());
      },
    });
  }
}