👨‍💻 Markdown笔记使用指南

Markdown笔记什么是Markdown?Markdown是一种轻量级的「标记语言」,通常为程序员群体所用,目前它已是全球最大的技术分享网站 GitHub 和技术问答网站 StackOverFlow 的御用书写格式。

有道云笔记内置Markdown编辑器和使用指南,非技术类笔记用户,千万不要被「标记」、「语言」吓到,Markdown的语法十分简单,常用的标记符号不超过十个,用于日常写作记录绰绰有余,不到半小时就能完全掌握。就是这十个不到的标记符号,却能让人优雅地沉浸式记录,专注内容而不是纠结排版,达到「心中无尘,码字入神」的境界。

Markdown笔记使用 Tips

实时同步预览,所看即所得

我们将笔记编辑界面一分为二,左边为编辑区,右边为预览区,两区滚动条同步。在编辑区的操作能够实时反映在预览区,方便及时调整和查看最终版面效果。

QRCode

工具栏内置Markdown语法,方便新手学习

编辑页面顶端的工具栏有对应代码,如果你是一个不熟悉Markdown语法的新手,可以先尝试用工具栏辅助操作。也可以在网上搜索「Markdown语法指南」进行学习。
当然,如果你觉得工具栏太打扰,点击下方分界条即可隐藏工具栏,切换到极简编辑环境。

实时云端保存

Markdown模式继承了有道云笔记的优良传统,你每一次击键的内容都会实时保存在云端,无需担心浏览器崩溃、设备没电、突然断网等情况。对于写作者来说,更是再也不用担心因为各种原因痛失文稿的情况了。

界面大小可点击分界条调整

点击“1”处,工具栏收起;
点击“2”处,右侧预览区收起。

QRCode

点击后效果如图

QRCode

桌面端7.1.8版本功能更新

在有道云笔记桌面端7.1.8版本更新后,在Markdown笔记原有能力的基础上,我们做了几项重磅升级

一、新增【所见即所得】编辑模式

新增了所见即所得的编辑界面,点击界面右上角的切换按钮即可选择切换。

二、新增行编辑菜单

在所见即所得的编辑界面,编辑文字内容时,选中的文字上方可生成悬浮工具栏,支持快速为目标内容添加格式。

三、新增斜杠唤起菜单

使用 / (斜杠)快速唤起工具栏,快速选择添加相关类型的内容。

四、新增块编辑菜单

可点击目标内容左侧的编辑块,在弹出的菜单中快速选择。

五、支持4类高亮块

在分屏编辑界面,可以使用下发语法实现高亮块格式

4类高亮块类型分别是:成功、信息、警告、危险,对应绿色、蓝色、黄色和红色高亮块。

语法详情:

::: success

块内文字

:::

六、表格快速编辑

在所见即所得界面,创建表格后,可选中表格,在弹出工具栏,点击对应选项快速完成以下操作:

  • 向左、右添加列
  • 向上、下添加行
  • 左对齐、右对齐、居中
  • 删除行、列

「简明版」有道云笔记Markdown指南

0 标题

标题是每篇文章必备而且最常用的格式。
在Markdown中,如果想将一段文字定义为标题,只需要在这段文字前面加上 #,再在 # 后加一个空格即可。还可增加二、三、四、五、六级标题,总共六级,只需要增加 # ,增加一个 # ,标题字号相应降低一级。如图:

QRCode

1 列表

列表格式也很常用,它可以让你的文稿变得井井有条。
在 Markdown 中,你只需要在文字前面加上 - 就可以了;如果你希望是有序列表,在文字前面加上 1. 2. 3. 即可。
注:-、1.和文字之间要保留一个字符的空格。

QRCode

2 引用

如果你需要在文稿中引用一段别处的句子,那么就要用到「引用」格式。
在引用文字前加上 > 并与文字保留一个字符的空格,即可

QRCode

3 粗体和斜体

Markdown 的粗体和斜体也非常简单:
用两个 * 包含一段文本就是粗体的语法;
用一个 * 包含一段文本就是斜体的语法。

QRCode

4 链接与图片

链接:在 Markdown 中,插入链接只需要使用:

[显示文本] (链接地址)

图片:在 Markdown 中,插入图片只需要使用:

![显示文本](图片链接地址)

注:插入图片的语法和链接的语法很像,只是前面多了一个 !

QRCode

5 分割线

分割线的语法只需要另起一行,连续输入三个星号 *** 即可分割两段文字内容。 如图

QRCode

6 表格

当你需要在Markdown文稿中键入表格,代码如下

QRCode

7 数学公式

1. 多行公式包裹在```math和```内,例如:

```math
e^{i\pi} + 1 = 0
```

得到:

2. 行内公式包裹在`$和$`内

例如:

`$E \neq mc^2$`是一个行内公式

得到:

3. 符号

3.1 导数符号
`$f'(x)$`

得到:

3.2 向量
`$\vec {a}$` `$\overrightarrow {P_0P_1}$`

得到:

3.3 希腊字母
`$\alpha$` `$\Alpha$` `$\beta$` `$\Delta$` `$\lambda$`

得到:

3.4 偏导数
`$\partial$`

得到:

3.5 加减乘除
`$a+b$` `$a-b$` `$a \times b$` `$a \div b$`

得到:

3.6 上下标
`$x^n$` `$x_n$`

得到:

3.7 集合
`$(0, 10) \cap (-2, 6)$` `$(-\infty,0) \cup (0,+\infty)$` `$k \in \bf {Z}$` `$D \subset R$`

得到:

3.8 积分
`$\int _{-\infty} ^{+\infty} e^x dx$`
`$\iint \limits _D f(x,y) dxdy$`

得到:

3.9 求和
`$\sum \limits _{i=1} ^n f(x)$`
`$\sum \limits _{\substack {0<i<m \\ 0<j<n}} f(x)$`

得到:

3.10 求积
`$\prod \limits _{k=1} ^n a_k$`

得到:

3.11 分数
`$\dfrac{a}{b}$`
`$\cfrac{a}{1 + \cfrac{1}{b}}$`

得到:

3.12 比较
`$x=y$` `$x \ne y$` `$x>y$` `$x \le y$` `$x \ge y$` `$x \approx y$`

得到:

3.13 矩阵
```math
\begin{vmatrix}
   a & b \\
   c & d
\end{vmatrix}
```

得到:

有道云笔记使用的公式语法是Katex,更多的符号以及其他细节可参考这里open in new window


如上8大格式是写作文稿时最常使用的。
怎么样,看了相关Markdown语法是不是觉得挺简单?
当然,Markdown新手在使用不熟练的情况下,可能会忘记相关语法,也没关系,笔记的工具栏内置了Markdown语法,方便学习与熟悉。
如,「表格」语法相对复杂,你可能忘记了,这时候,你只需要点击编辑框上方工具栏,点选「表格」的图标,左边编辑区便会出现「表格」相应代码。

QRCode

然后,你只需要将代码替换成相应文本即可,如图

QRCode

熟悉语法之后,还是建议大家少使用辅助工具栏,尽量自己键入代码,感受纯文本之美。
当然,有道云笔记的Markdown还能支持制作待办事项,书写流程图、序列图、甘特图,书写数学公式等,是不是够极客,够有逼格?
看看笔记君用Markdown甘特图写的项目计划时间表:

QRCode

「进阶版」有道云笔记Markdown指南


有道云笔记内置Markdown编辑器和使用指南。
“进阶版”有道云笔记Markdown指南,教你如何进一步掌握待办、清单、流程图和甘特图。

0 待办和清单

待办事项和清单在日常工作、生活中经常被使用。
在Markdown中,你只需要在待办的事项文本或者清单文本前加上- [ ]、- [x]即可。

- [ ] 表示未完成,- [x] 表示已完成。

注:键入字符与字符之间都要保留一个字符的空格。 具体呈现如下

QRCode

1 流程图

在Markdown中,一段流程图语法,以``` 开头,以```结尾。

在``` 后另起一行,书写graph XX,用以确定将要绘制的流程图及其类型(XX表示流程图类型)。

流程图分为竖向和横向两大类,竖向包括自上而下和自下而上两种顺序,横向包括从右到左和从左到右两种顺序。
其对应语法分别为:graph TB/graph BT/graph RL/graph LR。

  • TB - top bottom(自上而下)
  • BT - bottom top(自下而上)
  • RL - right left(从右到左)
  • LR - left right(从左到右)

简单示例如图

QRCodeQRCodeQRCodeQRCode

来学习一个具体案例

QRCode

仔细研究上述案例,会发现我们可以通过调整语法来调整流程图的框线、连接线,不同条件能导向不同结果。
①对框线形状的调整,如

QRCode

②对箭头的调整,如

QRCode

只要充分掌握该语法,再复杂的流程图也完全能用Markdown书写!
更详细的流程图语法,可参见:https://github.com/mermaid-js/mermaid

2 甘特图

我们在工作中用甘特图作计划进度表、项目进度表再合适不过了。
以如下甘特图为例说明

QRCode

与流程图一样,Markdown中,甘特图的语法也是以``` 开头,以```结尾。

在后另起一行,书写 gantt ,用以确定将要绘制的是甘特图。 标题的书写语法如下:

QRCode

dateFormat YYYY-MM-DD规定了时间轴,title (标题文本)表示甘特图标题。

如需按项目进行划分,需键入section,空一个字符,再输入项目名称的文本(一个section和另一个section之间要空行)。
每个大项目将拆解为若干个小任务,只需在section之后另起一行,直接输入小项目名称即可。