shuxin Markdown 格式一览
这是一篇排版示例。下面把 shuxin 当前支持的文字格式集中写一遍,方便查看标题、段落、列表、引用、链接、代码和表格的实际效果。链接现在使用蓝色和常驻下划线,在浅色与深色主题里都能与普通文字区分。
1. 段落与换行
这是第一段。用一个空行,就能开始新的段落。
这是第二段的第一行。
这是第二段的第二行:普通换行也会保留,不必强行把短句写在一行里。
这两行之间使用显式换行。
这里是换行后的内容。
2. 六级标题
标题使用一到六个 #。不同层级用来组织内容,不需要把整条动态变成一篇有固定标题的文章。
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
一级标题示例
这是一级标题下面的一小段文字。
二级标题示例
这是二级标题下面的一小段文字。
三级标题示例
这是三级标题下面的一小段文字。
四级标题示例
这是四级标题下面的一小段文字。
五级标题示例
这是五级标题下面的一小段文字。
六级标题示例
这是六级标题下面的一小段文字。
3. 加粗、斜体与删除线
普通文字,加粗文字,斜体文字,同时加粗和斜体,以及 删除线文字。
也可以使用下划线写法:加粗文字、斜体文字。
**加粗** 或 __加粗__
*斜体* 或 _斜体_
***加粗与斜体***
~~删除线~~
在一句话里混用:今天先完成 最重要的一件事,再留一点 不赶时间的空白;临时计划 可以划掉,但记录仍然留着。
4. 无序列表
- 随手记下一个想法
- 保存一段读书摘录
- 整理当天的小事
星号也可以写列表:
- 早晨的一杯咖啡
- 午后的一页书
- 晚上的一段记录
5. 有序与嵌套列表
- 打开编辑器
- 写正文或添加图片
- 选择可见性并发布
列表也可以嵌套:
- 文字记录
- 普通段落
- Markdown 排版
- 加粗和斜体
- 引用和代码
- 图片记录
- 选择图片
- 调整顺序
- 填写替代文字
6. 引用与嵌套引用
把当下的想法记下来,之后再慢慢整理。
引用可以包含多个段落,也可以带上 重点 和 链接。
第一层引用。
第二层引用:引用里还可以再引用一段话。
7. 链接的几种写法
普通文字:查看 shuxin 的开源项目。
内联链接:查看 shuxin 的开源项目。蓝色和下划线共同提示它可以点击。
带说明的链接:回到首页。桌面端悬停时可以查看链接说明。
站内相对链接:查看多图示例。
引用式链接:shuxin 开源仓库。同一个地址可以集中定义,再在正文中多次引用。
自动识别的网址:https://shuxin.goforit.si/
尖括号写法:https://github.com/5hux1n/shuxin
邮件链接:示例邮箱。这是演示地址,不用于实际联系。
[链接文字](https://example.com)
[带说明的链接](https://example.com "链接说明")
[站内页面](/search)
[引用式链接][source]
[source]: https://github.com/5hux1n/shuxin "开源项目"
8. 行内代码
一个字段、一条命令或一小段代码,可以写成 visibility、npm run dev 或 const note = "记录"。
反引号本身也能放进代码:这里包含一个 ` 符号。
9. 围栏代码块与缩进代码块
围栏代码块可以保留缩进和换行:
const note = {
content: "记录一个小想法",
status: "published",
visibility: "public",
};
console.log(note.content);
也可以用波浪线作为围栏:
{
"name": "shuxin",
"purpose": "记录日常"
}
每行缩进四个空格,也能形成代码块:
第一行:这里保留原始缩进。
第二行:可以继续缩进。
第三行:普通文本不会被当成 Markdown 排版。
代码块目前使用统一的等宽排版;语言名称不会自动变成语法高亮。
10. 表格与列对齐
| 靠左的内容 | 居中的状态 | 靠右的数量 |
|---|---|---|
| 纯文本 | 支持 | 1 |
| 加粗文字 | 支持 | 2 |
| 开源项目 | 可点击 | 3 |
行内代码 |
支持 | 4 |
| 靠左 | 居中 | 靠右 |
| :--- | :---: | ---: |
| 内容 | 状态 | 123 |
小屏幕里,宽表格可以横向滚动,不会把整个页面撑宽。
11. 分隔线
三个或更多的短横线、星号、下划线,都可以表示分隔线。下面分别展示三种写法。
第一段分隔后的文字。
第二段分隔后的文字。
第三段分隔后的文字。
12. 转义与特殊符号
想把符号作为普通文字显示,可以加反斜杠:*这不是斜体*,# 这不是标题,[这不是链接]。
行内代码也适合展示写法:**加粗**、# 标题、[链接](https://example.com)。
常见字符会正常保留:中文、English、123、&、©、→、☕。
13. 图片和暂不支持的扩展
本站的图片通过编辑器中的“添加图片”上传,显示在动态的媒体区域;GIF 与 Live Photo 也走各自的上传入口。当前不支持用  在 Markdown 正文中嵌入外部图片。
任务清单的勾选框、脚注、数学公式、Mermaid 图、文字颜色和自定义 HTML 布局不属于当前支持的格式。这篇只展示现有格式,不把这些扩展写成已经可用的功能。
14. 长文阅读
首页会折叠较长的正文,点击“展开全文”继续阅读;点击发布时间则可以进入独立页面,完整查看这篇内容。右上角可以切换浅色、深色或跟随系统。
如果你正在比较排版效果,可以重点看看:链接与普通文字是否易分辨、标题层级是否清楚、代码块是否易读,以及表格在手机上的横向滚动是否自然。