编辑与格式问题

这里汇总了 Obsidian 编辑和格式处理过程中的常见问题。

✏️ 基础编辑

如何插入图片和附件？

方法一：拖拽插入

直接拖拽图片到编辑器
自动保存到附件文件夹

方法二：粘贴插入

复制图片后 Ctrl/Cmd+V 粘贴
自动处理附件路径

方法三：使用命令

输入 ![[]] 后选择图片
或使用工具栏按钮

附件管理设置：

yaml

设置 → 文件与链接:
  新附件默认位置:
    - 仓库根目录
    - 当前文件所在文件夹
    - 指定文件夹（推荐）
  
  推荐路径: Attachments/

图片如何调整大小？

Markdown 语法：

markdown

![[image.png]]              # 原始大小
![[image.png|300]]          # 宽度 300px
![[image.png|300x200]]      # 宽 300px，高 200px
![[image.png|50%]]          # 50% 宽度

表格如何编辑？

基本语法：

markdown

| 列1 | 列2 | 列3 |
|-----|-----|-----|
| 内容 | 内容 | 内容 |

对齐方式：

markdown

| 左对齐 | 居中 | 右对齐 |
|:-------|:----:|-------:|
| 内容 | 内容 | 内容 |

表格内换行：

markdown

| 列1 | 列2 |
|-----|-----|
| 第一行<br>第二行 | 内容 |

推荐插件：

Advanced Tables - 增强表格编辑体验

代码块支持哪些语言？

常用语言：

语言	标识符
JavaScript	`javascript`, `js`
Python	`python`, `py`
HTML	`html`
CSS	`css`
JSON	`json`
YAML	`yaml`
Shell	`bash`, `shell`
SQL	`sql`
Markdown	`markdown`, `md`
Mermaid	`mermaid`

示例：

markdown

```javascript
function hello() {
  console.log("Hello, Obsidian!");
}
```

📝 格式问题

如何使用数学公式？

行内公式：

markdown

这是行内公式 $E = mc^2$ 示例。

块级公式：

markdown

$$
\frac{-b \pm \sqrt{b^2-4ac}}{2a}
$$

常用公式符号：

符号	语法
分数	`\frac{a}{b}`
根号	`\sqrt{x}`
求和	`\sum_{i=1}^{n}`
积分	`\int_{a}^{b}`
希腊字母	`\alpha, \beta, \gamma`

Callout 如何使用？

基本语法：

markdown

> [!note] 标题
> 这是内容

Callout 类型：

类型	用途
`note`	笔记
`tip`	提示
`warning`	警告
`danger`	危险
`info`	信息
`todo`	待办
`success`	成功
`failure`	失败
`bug`	错误
`example`	示例
`quote`	引用

可折叠：

markdown

> [!note]- 可折叠标题
> 默认折叠的内容

> [!note]+ 默认展开
> 可折叠但默认展开

标签如何使用？

基本语法：

markdown

#标签
#多层/标签/结构

标签使用建议：

yaml

命名规范:
  - 使用小写字母
  - 用连字符分隔单词
  - 层级不超过3层

示例:
  #项目/进行中
  #书籍/技术/编程
  #状态/待办

如何设置文本颜色？

方法一：HTML 标签

markdown

<span style="color: red">红色文本</span>
<span style="color: #ff0000">红色文本</span>

方法二：CSS 代码片段

css

/* 在 .obsidian/snippets/ 中创建 */
.color-red { color: red; }
.color-blue { color: blue; }

使用：<span class="color-red">红色文本</span>

🔗 链接问题

内部链接如何使用？

基本语法：

markdown

[[笔记名称]]                    # 链接到笔记
[[笔记名称|显示文本]]            # 带显示文本
[[笔记名称#标题]]               # 链接到特定标题
[[笔记名称#标题|显示文本]]       # 带显示文本的标题链接
[[笔记名称^block-id]]           # 链接到块

外部链接如何使用？

基本语法：

markdown

[显示文本](https://example.com)
<https://example.com>
<email@example.com>

如何嵌入其他笔记？

嵌入整个笔记：

markdown

![[笔记名称]]

嵌入部分内容：

markdown

![[笔记名称#标题]]
![[笔记名称^block-id]]

链接不生效？

检查清单：

yaml

1. 文件名是否正确
   - 注意大小写
   - 注意空格

2. 文件是否存在
   - 检查文件是否被删除
   - 检查文件路径

3. 语法是否正确
   - 双中括号 [[ ]]
   - 竖线分隔符 |

📊 高级格式

如何创建折叠内容？

方法一：Callout 折叠

markdown

> [!note]- 点击展开
> 隐藏的内容

方法二：HTML 详情标签

markdown

<details>
<summary>点击展开</summary>

隐藏的内容

</details>

如何创建多列布局？

使用 HTML/CSS：

markdown

<div style="display: flex; gap: 20px;">
<div style="flex: 1;">
左列内容
</div>
<div style="flex: 1;">
右列内容
</div>
</div>

如何创建目录？

自动目录：

markdown

[[_TOC_]]

使用插件：

自动目录插件
在设置中配置显示级别

如何使用脚注？

语法：

markdown

这是一个脚注示例[^1]。

[^1]: 这是脚注的内容。

多引用：

markdown

第一个引用[^1] 第二个引用[^2]

[^1]: 第一个脚注内容
[^2]: 第二个脚注内容

🖼️ 媒体处理

如何插入视频？

本地视频：

markdown

![[video.mp4]]

在线视频：

markdown

<iframe src="视频链接" width="560" height="315"></iframe>

如何插入音频？

语法：

markdown

![[audio.mp3]]

PDF 如何处理？

嵌入 PDF：

markdown

![[document.pdf]]

链接到 PDF：

markdown

[[document.pdf]]

PDF 标注：

使用 PDF 标注核心插件
或使用第三方插件

🎨 样式定制

如何自定义 CSS？

步骤：

创建 .obsidian/snippets/custom.css
添加 CSS 代码
设置 → 外观 → 启用代码片段

常用自定义：

css

/* 修改字体 */
.markdown-preview-view {
  font-family: '思源黑体', sans-serif;
}

/* 修改行高 */
.markdown-preview-view {
  line-height: 1.8;
}

/* 修改引用样式 */
blockquote {
  border-left: 4px solid #7c3aed;
  padding-left: 16px;
}

如何自定义主题？

方法一：使用现有主题

设置 → 外观 → 主题
浏览并安装主题

方法二：自定义 CSS

在主题基础上覆盖样式
使用 CSS 代码片段

如何修改代码块样式？

CSS 示例：

css

/* 代码块背景 */
pre code {
  background-color: #1e1e1e;
  border-radius: 8px;
}

/* 行内代码 */
code {
  background-color: #f0f0f0;
  padding: 2px 6px;
  border-radius: 4px;
}

⌨️ 编辑技巧

如何快速格式化？

快捷键：

操作	Windows/Linux	macOS
粗体	`Ctrl+B`	`Cmd+B`
斜体	`Ctrl+I`	`Cmd+I`
链接	`Ctrl+K`	`Cmd+K`
代码	Ctrl+`	Cmd+`

如何批量操作？

使用插件：

Find and Replace - 批量替换
Batch Operations - 批量操作

正则替换：

yaml

示例 - 将所有 ##标题 改为 ## 标题:
  查找: ^(#{1,6})([^#\s])
  替换: $1 $2

如何快速插入模板？

使用 Templater：

创建模板文件
设置快捷键
快速插入

使用核心模板插件：

创建模板文件夹
设置模板位置
使用命令插入

❓ 其他问题

换行不生效？

原因：

Markdown 需要两个空格或空行换行

解决方案：

markdown

第一行  
第二行（行末两个空格）

第一段

第二段（空一行）

中文排版问题？

解决方案：

css

/* 中文自动换行 */
.markdown-preview-view {
  word-break: break-word;
  line-break: auto;
}

/* 中英文间距 */
.markdown-preview-view {
  text-spacing: 0.1em;
}

复制粘贴格式丢失？

解决方案：

使用"粘贴为纯文本"
使用"粘贴并匹配样式"
安装格式化插件

撤销历史？

限制：

编辑器撤销历史有限
关闭文件后丢失

建议：

使用 Git 版本控制
定期保存快照
使用文件恢复插件

🔗 相关链接

💡 提示

熟练使用 Markdown 语法和快捷键可以大大提高编辑效率。建议打印 Markdown 速查表随时查阅。

编辑与格式问题 ​

✏️ 基础编辑 ​

如何插入图片和附件？ ​

图片如何调整大小？ ​

表格如何编辑？ ​

代码块支持哪些语言？ ​

📝 格式问题 ​

如何使用数学公式？ ​

Callout 如何使用？ ​

标签如何使用？ ​

如何设置文本颜色？ ​

🔗 链接问题 ​

内部链接如何使用？ ​

外部链接如何使用？ ​

如何嵌入其他笔记？ ​

链接不生效？ ​

📊 高级格式 ​

如何创建折叠内容？ ​

如何创建多列布局？ ​

如何创建目录？ ​

如何使用脚注？ ​

🖼️ 媒体处理 ​

如何插入视频？ ​

如何插入音频？ ​

PDF 如何处理？ ​

🎨 样式定制 ​

如何自定义 CSS？ ​

如何自定义主题？ ​

如何修改代码块样式？ ​

⌨️ 编辑技巧 ​

如何快速格式化？ ​

如何批量操作？ ​

如何快速插入模板？ ​

❓ 其他问题 ​

换行不生效？ ​

中文排版问题？ ​

复制粘贴格式丢失？ ​

撤销历史？ ​

🔗 相关链接 ​

编辑与格式问题

✏️ 基础编辑

如何插入图片和附件？

图片如何调整大小？

表格如何编辑？

代码块支持哪些语言？

📝 格式问题

如何使用数学公式？

Callout 如何使用？

标签如何使用？

如何设置文本颜色？

🔗 链接问题

内部链接如何使用？

外部链接如何使用？

如何嵌入其他笔记？

链接不生效？

📊 高级格式

如何创建折叠内容？

如何创建多列布局？

如何创建目录？

如何使用脚注？

🖼️ 媒体处理

如何插入视频？

如何插入音频？

PDF 如何处理？

🎨 样式定制

如何自定义 CSS？

如何自定义主题？

如何修改代码块样式？

⌨️ 编辑技巧

如何快速格式化？

如何批量操作？

如何快速插入模板？

❓ 其他问题

换行不生效？

中文排版问题？

复制粘贴格式丢失？

撤销历史？

🔗 相关链接