使用 Markdown 写作
Markdown 格式是纯文本加上少量符号:# 是标题,** 是加粗,- 是列表。青苔读取标准 Markdown(CommonMark 与 GitHub 风格),并在此之上支持 Obsidian 风格的 Wikilink 与嵌入、短代码和标注。
因为是纯文本,你可以用任何编辑器书写,文件始终留在你自己的电脑上。
基础语法
左边是你写的,右边是青苔渲染的结果:
## 小标题
一段普通文字,可以**加粗**或*倾斜*。
- 列表的一项
- 另一项
> 一段引用。
[一个链接](https://example.com)
需要完整的语法速查,可参考 Markdown 语法速查表,或 Obsidian 的基础格式语法。
换行与新段落
Markdown 中,换行新起的一行文字在渲染之后与上一行仅隔一个空格。如果你想要新起一个段落,就在两段之间隔一空行。
在诗歌等文体的排版中,如果你想要新起一行、而中间不隔空行,你可以在上一行结尾处增加两个空格。
青苔的扩展
在标准 Markdown 之外,青苔还认得几种记号,各有专门的文档:
- Wikilink 与嵌入:用
[[双方括号]]链接和嵌入其他页面与媒体。 - 短代码:用
:::围栏创建多栏、图库、大图等布局。 - Frontmatter:在文件顶部用 YAML 设置标题、日期、可见性等属性。
用什么写
青苔自带一个所见即所得的 Markdown 编辑器,右键文件夹选择「发布」即可开始。你也可以用任何顺手的编辑器,比如 Obsidian、iA Writer、Typora 或 VS Code。青苔会监视文件夹,一保存就更新预览。