在实时编辑器中设置文本格式

您可以将格式化文本、超链接、表、图像和方程添加到实时脚本和函数中，以创建要与其他人共享的演示文档。

要插入新项目，请转到插入选项卡，然后从可用选项中选择。

选项	描述	其他详细信息
代码	插入空的代码行。	您可以在文本行之前、之后或之间插入代码行。
分节符	插入分节符。	您可以插入分节符，将实时脚本或函数分为易于管理的节，以便分别求值。节可以包括代码、文本和输出。有关详细信息，请参阅创建和运行代码节。
文本	插入空的文本行。	文本行可以包含格式化文本、超链接、图像或方程。您可以在代码行之前、之后或之间插入文本行。
目录	插入目录。	目录包含文档中所有标题的列表。如果文档只包含一个标题，则它不包含在目录中。只有目录的标题是可编辑的。您只能在文本行中插入目录。如果您将目录插入到代码行中，MATLAB^® 会将其置于当前代码节的上一行。将包含目录的实时脚本导出为 Microsoft^® Word 时，默认情况下，生成文档的目录不包含页码。要添加页码，请点击目录并选择更新表。
代码示例	插入格式化的代码示例。	代码示例是显示为缩进的等宽文本的示例代码。选择纯文本可将示例代码作为非突出显示的文本插入。选择 MATLAB 可根据 MATLAB 语法将示例代码作为突出显示的文本插入。
表	插入一个表。	您只能在文本行中插入表。如果您向代码行中插入表，则 MATLAB 会将该表置于选定代码行正下方的新文本行中。要指定表大小，请选择表，将光标移到网格上以突出显示需要的行数和列数，然后点击以添加表。要创建更大的表，请点击表按钮，并在对话框中指定行数和列数。插入表后，您可以修改该表的行和列：插入或删除行和列 - 右键点击表，选择表，然后从可用的插入和删除选项中进行选择。调整列的大小 - 点击并拖动列的边缘。要重置列宽，请右键点击并选择表 > 重置列宽。使第一行成为标题行 - 右键点击表并选择表 > 打开标题行。
图像	插入图像。	您只能在文本行中插入图像。如果您向代码行中插入图像，则 MATLAB 会将该图像置于选定代码行正下方的新文本行中。要在插入图像后更改图像的替换文本、对齐方式和大小，请右键点击图像并从上下文菜单中选择编辑图像...。替换文本 - 向编辑字段添加文本以指定图像的替换文本。对齐方式 - 从可用选项中选择，以指定图像如何与行中的其他项目对齐。大小 - 要指定相对于原始图像大小的大小，请选择相对(%)，并将图像的宽度和高度指定为原始图像的一定百分比。要指定绝对大小，请选择绝对(px)，并以像素为单位指定图像的宽度和高度。选择保持纵横比以在调整大小时保持纵横比。要恢复为原始图像大小，请右键点击图像并选择重置图像。
超链接	插入超链接。	您只能在文本行中插入超链接。如果您向代码行中插入超链接，则 MATLAB 会将该超链接置于选定代码行正下方的新文本行中。选择网页可插入指向外部网页的超链接。然后，输入网页的 URL。选择现有文档中的位置，以在单独的实时脚本或实时函数中插入指向特定位置的超链接。输入或浏览到该文件路径，然后在右侧显示的文档预览中选择一个位置。选择文档中的位置以插入指向文档中一个现有位置的超链接。出现提示时，点击文档中的所需位置以将其选为目标。您还可以使用 Alt + 向上箭头和 Alt + 向下箭头键盘快捷方式。位置可以是代码节、文本段落或标题。不支持链接到单行文本或代码。选择现有文件可插入指向文件的超链接。然后，输入文件路径。
方程	插入方程。	您只能在文本行中插入公式。如果您向代码行中插入方程，则 MATLAB 会将该方程置于选定代码行正下方的新文本行中。有关详细信息，请参阅将方程插入实时编辑器中。

要设置现有文本的格式，请使用实时编辑器选项卡的文本部分中包含的各个选项：

格式类型	选项
文本样式	普通标题 1 标题 2 标题 3 标题
文本对齐方式	左对齐居中对齐右对齐
列表	编号列表项目符号列表
标准格式设置	加粗斜体下划线等宽

要将所选文本或代码全部由大写更改为小写（或者反之），请选择文本，点击鼠标右键，然后选择更改大小写。也可以按 Ctrl+Shift+A。如果文本中同时包含大写和小写文本，则 MATLAB 会将它们全部更改为大写。

更改字体

您可以在实时编辑器中调整显示的字体大小，或使用设置来更改代码和文本的字体名称、样式、大小和颜色。

要增大或减小实时编辑器中显示的字体大小，请使用 Ctrl + 加号 (+) 和 Ctrl + 减号 (-) 键盘快捷方式或按住 Ctrl 并滚动鼠标滚轮来放大或缩小。在 macOS 系统上，使用 Command 键而不是 Ctrl 键。将实时脚本导出为 PDF、Microsoft Word、HTML、LaTeX、Markdown 或 Jupyter^® Notebook 时，显示字体大小的变化不会保留。

使用设置可以更改代码和文本的字体名称、样式、大小和颜色。例如，以下代码将更改实时编辑器中标题的颜色和样式：

s = settings;
s.matlab.fonts.editor.title.Style.PersonalValue = {'bold'};
s.matlab.fonts.editor.title.Color.PersonalValue = [0 0 255 1];

以下代码增大实时编辑器中普通文本的大小并更改其字体名称：

s = settings;
s.matlab.fonts.editor.normal.Size.PersonalValue = 20;
s.matlab.fonts.editor.normal.Name.PersonalValue = 'Calibri';

实时编辑器会更新所有打开的实时脚本和实时函数以显示所选字体。当您创建新的实时脚本或函数时，也会应用所选字体。

Live script with a title that is blue and bold, and a line of normal text in Calibri size 20 font

有关详细信息，请参阅 matlab.fonts 设置

自动格式化

要在实时脚本和函数中快速进行格式化，您可以将键盘快捷方式和字符序列结合使用。当您输入序列中的最后一个字符后，即会显示格式设置。

下表列出了格式化样式及其可用的键盘快捷方式和自动格式化序列。

格式化样式	自动格式化序列	键盘快捷方式
标题	`# text` + Enter	Ctrl + Alt + L
标题 1	`## text` + Enter	Ctrl + Shift + 1
标题 2	`### text` + Enter	Ctrl + Shift + 2
标题 3	`#### text` + Enter	Ctrl + Shift + 3
带标题 1 的分节符	`%% text` + Enter	将光标置于带有 `text` 的行的开头： Ctrl + Shift + 1，然后按 Ctrl + Alt + Enter
分节符	`%%` + Enter `---` + Enter `*` + Enter**	Ctrl + Alt + Enter
项目符号列表	`* text` `- text` `+ text`	Ctrl + Alt + U
编号列表	`number. text`	Ctrl + Alt + O
斜体	`text` `_text_`	Ctrl + I
加粗	`text` `__text__`	Ctrl + B
加粗和斜体	`*text*` `___text___`	Ctrl + B，然后按 Ctrl + I
等宽	`text` `\|text\|`	Ctrl + M
下划线	无	Ctrl + U
LaTeX 方程	$LaTeX$	Ctrl + Shift + L
超链接	`URL` + 空格或 Enter `<URL>` `[Label](URL)`	Ctrl + K
商标、服务标记和版权符号（™、℠、® 和 ©）	`(TM)` `(SM)` `(R)` `(C)`	无

注意

标题、分节符和列表序列必须在行开头输入。

有时，您可能希望自动格式化序列（例如 ***）按字面显示。要显示序列中的字符，请按 Backspace 键或点击撤消以退出自动格式化。例如，如果您键入 ## text + Enter，则会显示标题 1 样式并带有单词 text 的标题。要撤消格式化样式并只显示 ## text，请按 Backspace 键。您只有在完成序列后立即操作，才能从序列中退出。当您输入其他字符或移动光标之后，便无法再退出。

要恢复 LaTeX 方程和超链接的自动格式化，请随时使用 Backspace 键。

要强制格式化在退出序列后重新出现，请点击重做按钮。您只能在退出操作后立即重做该操作。一旦您输入其他字符或移动光标，便无法执行重做。在这种情况下，要强制格式化重新出现，请删除序列中的最后一个字符，然后再次键入该字符。

要禁用所有或部分自动格式化序列，您可以调整编辑器/调试器自动格式化预设项。

另请参阅

export