思源笔记用户指南HTML块
type
status
date
slug
summary
tags
category
icon
password
网址
基本使用
- 通过输入
/html命令插入HTML块
- 默认会对代码进行安全过滤（防XSS攻击），如需执行脚本需手动开启：
设置-编辑器-允许执行HTML块内脚本
代码规范
- 因为 Markdown 规范对 HTML 块解析规则较为复杂，建议使用
<div></div>包裹 HTML 代码并去掉空行
- 需要去掉代码中的空行（Markdown解析规则要求）
- 表格中需使用
\|时要转义为\\|
特殊功能
- 可保存为模板快速调用
- 支持通过CSS/JS实现复杂效果（如画廊视图、折叠代码块等）
注意事项
- 内容丢失风险：转换为HTML块后若刷新可能丢失原始内容
- 插件冲突：某些插件可能导致意外转换为HTML块（如文档中提到的块转换插件问题）
- 移动端兼容性：部分HTML功能在移动端可能受限
问题排查
- 查询所有HTML块：
- 开发工具可检查DOM结构（data-type="NodeHTMLBlock"）
- 查询所有 HTML 块：
使用 HTML 块时默认会对其中的代码进行安全过滤，如果不需要过滤，请开启
设置 → 编辑器 → 允许执行 HTML 块内脚本，但请确认代码安全后再开启，以免遭遇跨站脚本攻击（XSS）上一篇
列表项块
下一篇
Mermaid
Loading...