开始03-让文章不只是文字
2 min read
专栏:搭建你的第一个站点3 / 4
- 1开始01-十分钟创建个人网站
- 2开始02-写第一篇文章
- 3开始03-让文章不只是文字
- 4开始04-组织内容,换个样子
先说结论
Vergil 有 51 个内容指令,日常写作常用的不到十个。这篇挑几种写作中最常遇到的情况,每种配一个指令,你看到的效果都是直接写在这篇文章里的。
上面这块就是第一种情况:开头先给结论,用 note 高亮块。读者扫一眼就知道这篇讲什么,要不要往下读。
强调一个词
一句话里只有一个词最重要时,不用整句加粗,给它加个高亮就够了。行内指令只有一个冒号::mark[文字]。
列一份待办
写计划、写复盘时,用复选框比列表更直观:
读完这个专栏
写第一篇文章
给文章配上横幅
推送上线
对比两段代码
同一件事的两种写法,放进一个 panel 里并排对照,每段都能单独复制:
npm
npm install
npm run devpnpm
pnpm install
pnpm dev推荐一个开源项目
与其贴一个光秃秃的链接,不如放一张 GitHub 卡片,星标数和简介会自动拉取:
让读者复制一行命令
读者要照着敲的命令,放进 copy,点一下就复制好了:
创建站点
别用太多
指令是为了让信息更好读,不是为了炫技。一篇文章里每隔两段就冒出一个彩色框,真正重要的内容反而会失去分量。拿不准的时候,先用普通的 Markdown 写,确实需要时再换成指令。
看这篇文章的写法
:::note{title="先说结论"}
Vergil 有 51 个内容指令……
:::
一句话里只有一个词最重要时,:mark[给它加个高亮]就够了。
:checkbox[读完这个专栏]{checked="true" color="green"}
:checkbox[给文章配上横幅]
:::panel
```bash title="npm" right="传统"
npm install
```
```bash title="pnpm" right="推荐"
pnpm install
```
:::
:::ghcard{type="repo" repo="vergil-astro/vergil-astro-theme"}
:::
:::copy{label="创建站点"}
vg init my-site
:::每个指令的全部参数和更多用法见文档:
下一篇讲文章多起来之后怎么组织,以及怎么把站点换成你喜欢的样子。
© 本文著作权归作者所有,转载请注明出处。