Article / Writing
Markdown 写作示例
展示标题、列表、引用、代码、题目卡片、云剪切板、提示卡片与表格在博客中的排版效果。
Markdown 让写作者把注意力放在内容本身,而不是复杂的排版工具上。
代码块
const site = {
name: "Aier's blogs",
principle: 'Keep building.',
};
console.log(site.name);
Mermaid 图表
将代码块的语言标记为 mermaid,就能用文本绘制图表。文章和后台即时预览都会渲染,并跟随深浅主题切换。语法错误时保留源码,方便检查。
flowchart TD
A[开始写作] --> B[编写 Markdown]
B --> C{预览满意吗?}
C -->|继续修改| B
C -->|确认| D[从发布台发布]
D --> E[读者浏览文章]
sequenceDiagram
participant A as 作者
participant B as 管理后台
participant C as 博客
A->>B: 保存文章
B-->>A: 返回即时预览
A->>B: 在发布台发布
B->>C: 构建并更新静态页面
C-->>A: 文章上线
云剪切板
较长代码可以放在独立的剪切板页面中,正文只展示紧凑的引用卡片。点击标题会在新标签页打开代码详情。
可折叠提示卡片
补充说明可以放进默认折叠的 Callout 中,读者需要时再展开查看。
为什么使用原生折叠元素?
原生折叠元素无需额外脚本,并且支持键盘操作。正文仍然可以使用 Markdown:
- 添加多段说明
- 插入相关链接
- 展示
行内代码
外部引用卡片
外部资料可以写成紧凑的引用卡片,标题和简介直接保存在 Markdown 中。点击标题会在新标签页打开目标网页。
题目卡片
算法题可以使用题目卡片展示名称、跳转链接、难度颜色与多个分类。点击题目名称会在新标签页打开目标页面。
难度支持 red、orange、yellow、green、cyan、blue、purple、black 八种颜色。
引用
好的工具不会抢走注意力,而是让想法更自然地抵达读者。
列表
- 写下想法。
- 在本机预览。
- 提交到 Git。
- 一条命令部署。
表格
| 能力 | 实现方式 |
|---|---|
| 内容 | Markdown |
| 构建 | Astro |
| 服务 | Nginx |
| 发布 | SSH 原子部署 |
这篇文章也会作为新样式的长期回归测试页面。
数学公式
令
文章插图
