石墨文档支持实时Markdown渲染，无需切换模式，输入#、##等符号可生成标题，-或1.可创建列表，代码或`语言可插入代码块，|列|分隔符|可建表格，快捷键Ctrl+Shift+8等提升效率，注意空格与格式规范避免渲染异常。
如果您在石墨文档中希望高效编写结构清晰、格式统一的文档，Markdown 是一种轻量级标记语言，支持快速输入标题、列表、代码块等元素。以下是石墨文档中使用 Markdown 的具体操作步骤：
一、启用 Markdown 输入模式
石墨文档默认支持实时 Markdown 渲染，无需额外开启插件或切换模式，只要按规范输入符号即可自动转换为对应格式。
1、新建一个空白文档或打开已有文档。
2、在编辑区域直接输入 Markdown 语法，例如输入 # 一级标题 后回车，系统将自动渲染为大号标题。
3、输入过程中若未立即渲染，可确认光标位于段落末尾并按下回车键触发解析。
二、常用 Markdown 语法及对应效果
石墨文档兼容主流 Markdown 语法，输入特定符号组合后，内容会即时呈现为结构化样式。
1、输入 ## 二级标题 并回车，生成二级标题样式。
2、输入 - 列表项 或 * 列表项，生成无序列表。
3、输入 1. 第一项，随后换行输入 2. 第二项，生成有序列表。
4、输入 `代码片段`（单反引号），生成行内代码；输入三个反引号后换行，再输入语言标识如 ```python，可创建语法高亮代码块。
5、输入 [链接文字](https://example.com)，生成可点击超链接。
三、插入表格的 Markdown 写法
石墨文档支持通过管道符和短横线组合创建表格，输入后自动渲染为对齐表格。
1、输入第一行表头，用竖线分隔各列，例如：| 姓名 | 年龄 | 城市 |
2、在下一行输入分隔线，格式为：|---|---|---|
3、接着输入数据行，同样用竖线分隔，例如：| 张三 | 28 | 北京 |
4、完成输入后，整段内容将被识别为表格并渲染显示。
四、使用快捷键快速插入 Markdown 元素
石墨文档提供键盘快捷方式，可跳过手动输入符号，提升 Markdown 编写效率。
1、将光标置于某行开头，连续按两次 # 后空格，自动生成一级标题格式并进入编辑态。
2、选中一段文字，按下 Ctrl + Shift + 8（Windows）或 Cmd + Shift + 8（Mac），为其添加无序列表标记。
3、选中文本后按下 Ctrl + Shift + 7（Windows）或 Cmd + Shift + 7（Mac），添加有序列表编号。
4、选中文本后按下 Ctrl + K（Windows）或 Cmd + K（Mac），弹出链接插入框，填写 URL 即可生成 Markdown 链接。
五、处理 Markdown 渲染异常的方法
当输入符合语法却未正常渲染时，可能是因空格、换行或嵌套不规范导致解析失败。
1、检查符号与文字之间是否存在多余空格，例如 #标题 应改为 # 标题（井号后需加空格）。
2、确认列表项前后无缩进，且每项独占一行，避免与其他段落粘连。
3、代码块必须以独立的三个反引号起始和结束，且首尾反引号所在行不能包含其他字符。
4、表格中每一行的竖线数量须一致，表头与分隔线列数需完全对应，否则整张表格无法渲染。
