👨‍💻 Markdown笔记使用指南

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

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

Markdown笔记使用 Tips

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

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

QRCode

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

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

实时云端保存

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

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

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

QRCode

点击后效果如图

QRCode

「简明版」有道云笔记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大格式是写作文稿时最常使用的。
怎么样,看了相关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之后另起一行,直接输入小项目名称即可。