Mikipage 中的 Markdown
笔记使用 Markdown 编写——这是一种轻量级格式语法，GitHub、Reddit 和大多数笔记工具都在使用。你完全不必学习它：编辑器上方的工具栏会为你插入本页中的每一种语法，而纯文本编辑器（编辑器 → “使用纯文本编辑器（无 markdown）”）则完全跳过格式设置。
本页完整介绍 Mikipage 所支持的内容。
🧩 表示 Mikipage 扩展——这种语法在这里有效，但不属于标准 Markdown，因此将笔记粘贴到其他工具中时不会以相同方式呈现。 未标记的内容都是普通 Markdown，可以在任何地方使用。
文本
**粗体** *斜体* ~~删除线~~ `代码`
粗体、斜体、删除线、代码。
工具栏：B 和 I 各有专属按钮；删除线位于 工具 下。
标题
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
标题能让长篇笔记变得易于浏览，也是目录的构建依据。工具栏：样式。
列表
- 项目符号列表项
- 另一个项目
- 缩进一级的项目
1. 编号列表项
2. 渲染时编号会自动重新排列
- [ ] 待办事项
- [x] 已完成事项
在列表项末尾按 Enter，下一项会自动开始；在空列表项上再次按下它即可结束列表。Tab 和 Shift+Tab 可用于缩进和取消缩进。工具栏：列表。
引用
> 一段引用文字。
> 可以跨越多行。
工具栏：样式 → 引用。
链接和图片
[链接文字](https://example.com)
如果要链接已有的图片，不要手动编写这些内容——请使用 插入 → 插入图片，它会上传文件并为你写入引用（见下方的 附件）。
水平线
---
在它上方保留一个空行。直接写在文本行下方时，--- 在 Markdown 中表示其他含义：它会将该行变成标题。
表格
| 配料 | 数量 |
| --- | --- |
| 面粉 | 500g |
| 水 | 350g |
源文本中的列不必对齐——只有 | --- | 分隔行是必要的。工具栏：插入 → 表格。
代码
在上下方各单独占一行写三个反引号：
```
git commit -m "message"
```
允许在开头的反引号后写明语言（```python），并且可以正常跨工具使用。
与标准 Markdown 的一个区别 🧩：在此处，将一行缩进四个空格不会使其成为代码。在笔记应用中，这条规则意外触发的情况远多于有意使用的情况——粘贴的段落或悬挂缩进可能会悄无声息地变成灰色框。围栏代码是编写代码的唯一明确方式。
Mikipage 扩展
以下内容都是我们的扩展。它们让笔记不只是一份文本文件，而且都不属于标准 Markdown。
🧩 第一行会成为标题
如果笔记的第一行恰好是一级标题，那么该文本就是笔记的标题——它会显示在笔记列表、搜索结果以及指向该笔记的每个链接中。
# 酸面团酵头，第 3 周
早上 8 点喂过。四小时后翻了一倍，是目前最快的一次。
如果没有标题，笔记会以开头文本的预览来标识。不会有任何内容出错；只是标题更便于浏览。
🧩 井号标签会变成标签
在正文任意位置写入井号标签，它就会成为笔记上的真实标签——可在搜索中筛选，也可以点击它查看所有带有该标签的其他内容。
完成季度报告。#work #q3
如有需要，规则如下：
- 任何语言的字母、数字和下划线均可使用。标签必须至少包含一个字母，因此单独的
#2026不是标签。 - 井号标签不能直接跟在字母或数字后面，因此
you#me不是标签。 - 标签会转换为小写：
#Work和#work是同一个标签。 - 网址会保持原样，因此以
#section结尾的 URL 不会创建标签。
你从来不必给任何内容加标签——AI 仅凭含义就能找到相关笔记。标签适合在你想要进行严格、精确的筛选时使用。
🧩 数学公式
美元符号之间的 LaTeX。在句子中嵌入公式时使用一对美元符号：
关系式 $E = mc^2$ 仍然让我感到惊讶。
如果公式要单独居中显示，请将 $$ 单独放在上下两行：
$$
\int_0^\infty e^{-x}\,dx = 1
$$
工具栏：插入 → 数学块和插入 → 行内数学公式。这与 Obsidian 使用的是相同语法，因此笔记可以在两者之间直接迁移，无需编辑。
需要了解两点：
- 对于居中的公式，请将
$$单独放在一行。将其内嵌写成$$x$$时，它会显示在句子中间。 - 价格不会受到影响。“它花费了 $5 和 $10”会保留为文本，因为公式不能在空格旁开始或结束，也不能紧跟数字。如果某个多余的
$确实变成了公式，请写成\$将其强制恢复为普通文本。
🧩 预格式化块
标记为 plain 的围栏块会渲染为字面意义上的等宽文本——其中的任何内容都不会按 Markdown 解析，长行也会自动换行，而不是横向滚动。
```plain
尊敬的先生/女士：
项目 数量
------------ ---
小部件 4
```
它适用于任何必须完全保持输入形式、但又不是代码的内容：粘贴的输出、地址块、ASCII 艺术、想要展示而不是应用的 Markdown 片段。工具栏：插入 → 预格式化块。
🧩 时间线
标记为 timeline 的围栏块会渲染为垂直时间线。每行一个事件，三个字段由竖线分隔：
```timeline
2026-01-15 | 启动会议 | 确定了范围和预算。
2026-03-02 | 初稿 | 已发送审阅；仍缺少两章。
2026-05-20 | 发布 | 正式上线，第一周注册人数为 1,200。
```
没有日期和标题的行会被跳过。描述支持 Markdown。工具栏：插入 → 时间线。
🧩 目录
将此标记单独放在一行上，它会被替换为笔记标题的链接列表：
```table-of-content
PLACEHOLDER
工具栏：**插入 → 目录**。
### 🧩 对其他笔记和页面的引用
你可以在行内将一个笔记链接到另一个笔记：
最简单的写法是从笔记列表中拖出一个笔记并放入编辑器——引用会自动插入。粘贴完整的笔记 URL 也可以。语法与 Obsidian 使用的语法相同，因此你可以在竖线后添加标签（`[[note:0d5c…|Q3 planning]]`）——将鼠标悬停在引用上时会显示该标签——或者指向某个标题（`[[note:0d5c…#Goals]]`）。页面的引用方式相同，使用 `[[page:<id>]]`。
指向笔记的标准 Markdown 链接也属于引用，并会显示为普通链接文字，而不是引文：
生成页面上的引文也使用这些相同的引用：AI 编写页面时，每个陈述都会带有一个指向其来源笔记的引用。
### 🧩 附件存在于文本中
附加文件或插入图片时，笔记正文中会放置一个引用：
Loading...
正文是所附内容的唯一事实来源——因此删除引用并保存会删除底层文件（会先询问你），而移动引用会改变文件显示的位置。图片会在行内渲染；其他内容则会显示为下载链接。
请使用 **插入 → 插入图片** / **插入 → 附加文件** 来创建这些引用，而不要手动编写：文件上传之前，ID 并不存在。
### 🧩 导航
标记为 `navigation` 的围栏块会将嵌套的笔记引用列表渲染为导航菜单，而不是普通文字。AI 会将其写入页面的侧边栏，但它本质上是纯 Markdown，你也可以在任意笔记中自行编写：
~~~
```navigation
- 开始使用
- [[note:0d5c8f2a-6b1e-4a77-9c3d-1e2f8a4b6c90]]
- 参考
- [[note:7b1e4a77-9c3d-4a77-8f2a-1e2f8a4b6c90]]
不包含引用的列表项会作为分区标题。
---
## 关于 HTML 的说明
标准 Markdown 允许你将原始 HTML 放入文档。Mikipage 允许使用一小部分安全子集——基本的文本和布局标签——并会移除其他所有内容，包括脚本、样式以及任何可能从其他网站加载内容的元素。如果你写入的标签在笔记渲染时消失了，原因就在这里：请改用 Markdown 的等效写法。
## 了解更多
- [Markdown](https://en.wikipedia.org/wiki/Markdown)（维基百科）——Markdown 的起源以及还有哪些人在使用它。
- [开始使用 Markdown](https://www.markdownguide.org/getting-started/)——一篇适合用十分钟阅读的文章，更深入地介绍标准语法。
- [[note:p6yy7fmq]]——在 Mikipage 中编写笔记：编辑器、附件、限制以及 AI 可以读取的内容。
No comments yet.