从Obsidian迁移到Markpad：Wikilinks、Callouts与![[嵌入]]语法一次玩明白-育师

桌面应用
文档

【免费下载链接】Markpad

The Notepad equivalent for Markdown

项目地址：https://gitcode.com/gh_mirrors/mar/Markpad

Markpad是一款轻量免费的 Markdown 编辑器（Notepad 的 Markdown 平替，内存占用仅 ~10MB），它对来自Obsidian的三大标志性语法——Wikilinks（[[...]]双链跳转）、Callouts（提示框）与![[...]]嵌入——都做了原生支持，让你在熟悉的书写习惯下获得近乎实时的 GitHub 风格预览。

语法	Markpad 支持	语法说明位置
`[[Note#Heading]]`双链	✅	markdown-syntax.md · Wikilinks
`> [!NOTE]`提示框	✅（比 GitHub 多 5 种，还带折叠）	markdown-syntax.md · Quotes and alerts
`![[image.png]]`嵌入	✅ 支持尺寸参数	markdown-syntax.md · Images and embeds
`^block-id`块引用	✅	markdown-syntax.md · Block ids

整套语法对照表见项目说明：README.zh-CN.md。

Wikilinks 双链怎么用：`[[笔记#标题]]`一步跳转

在 Markpad 中输入[[#或[[文件名#，编辑器会自动补全当前文档（或目标文件）里的标题——这套补全逻辑由 headingCompletion.ts 实现。

三种常用写法：

[[#1. Text]]：跳转本文档内的标题
[[stress-test#6. Tables]]：跳转另一篇笔记的指定标题
[[stress-test#6. Tables|别名]]：用|自定义显示文字，如完整示例

点击预览中的链接会在新标签页打开目标笔记，前后导航和浏览器一样自然；文件解析规则见 localFileLinks.ts，双链的改写由 Rust 端 markdown.rs 完成。

💡两个容易踩的坑
不带#的裸双链（如[[Notes]]）会被原样保留为纯文本——因为这种写法同时是文献编号和 CommonMark 引用链接，Markpad 宁可不猜，见 wikilink 测试。要跳转就带上标题。
双链解析文件时自动帮你补.md后缀：[[sub/deep#Setup]]直接指向sub/deep.md，相对路径规则与x完全一致。
想在正文中显示字面的[[x]]？用反斜杠转义：\[\[Notes\]\]。

Callouts 提示框：比 GitHub 多 5 种，还能折叠

GitHub 的[!NOTE]、[!TIP]、[!IMPORTANT]、[!WARNING]、[!CAUTION]五种 Markpad 全部支持，另外独家再送五种：

[!INFO]、[!TODO]、[!FAQ]、[!QUESTION]、[!EXAMPLE]
折叠形态：标题后加+（默认展开）或-（默认折叠），如[!NOTE]+，点击标题即可开合——Obsidian 里的> [!faq]-习惯可以无缝沿用

嵌套也完全支持，> >一层层往里套；编辑器里在引用内按Enter还会自动续写>标记，退出引用只需删掉空行里的>。

`![[嵌入]]`语法：图片、视频、音频都能内嵌

Obsidian 的嵌入写法在 Markpad 中同样生效，解析逻辑见 markdown.rs 中的嵌入正则：

![[lightmode.png]]：嵌入本地图片，路径相对当前文档解析，与普通图行为一致
![[demo.png|300x200]]：|宽x高控制显示尺寸
视频音频变播放器：录屏指向mp4/webm/ogg/mov或mp3/wav/aac/flac/m4a时，会渲染成带控制条的播放器

比手打更省事的三个技巧：

拖图片进编辑器，自动帮你写好图片引用
拖.md文件到任意窗格，直接在标签页中打开
从资源管理器复制图片文件再粘贴，Markpad 会把图片保存到文档旁边并写入引用；存放目录可在设置 → Editor 中配置，支持${filename}占位符（如notes/trip.assets），规则见 openFileMode.ts

进阶：给任意段落打锚点`^block-id`

标题以外的段落也能被双链精确指向：在行尾写上^demo-block，再用[[#^demo-block]]即可链接到这一整段（语法示例）。正则定义见 markdown.rs。另外，预览中鼠标悬停在标题上会出现锚点图标，右键Copy Reference会按文档现有风格自动生成[[…]]或[…](#…)链接。

新手上手清单：把示例文档喂给 Markpad 或 AI

打开语法全集 samples/markdown-syntax.md（中文读者可看 markdown-syntax.zh-CN.md）：右侧预览展示每个效果的最终长相，左侧编辑器展示写法
把这份文件丢给 AI，就能让它按 Markpad 能渲染的范围重写你的旧笔记
相关行为均有测试守护：wikilinkFileTargets.test.ts、imageEmbed.test.ts，双链与标准链接可混用而不冲突

Markpad 跨 Windows / macOS / Linux，免费开源、无遥测。装好它，Obsidian 的双链书写肌肉记忆可以直接复用，剩下的只是更轻的体验。