Markdown语法学习笔记

本文是以马克飞象为工具学习Markdown语法,使用的都目前版本支持的语法。一些HTML等高级语法,暂时没有涉及。


[TOC]

标题

以#开头标记的是标题
多个#######标记的是不同大小的标题
注意,开头的标签和正文,最好空一格,虽然它不是必须的

有序列表和无序列表

  • 开头用-短横杠是无序列表
  • 回车可以自动标记
  • 可以流畅的完成列表
    • 列表不同的缩进会自动分层
  1. 以数字123加上英文句号.开头的是标记带有数字的列表
  2. 同样是自增形列表

强调和删除

使用两个星号**包围起来的文字,是 粗体
使用一个星号*包围起来的文字,是 斜体
使用“(Tab键上面那个点)来包围起来的文字,会被红色显示 使用~`两个波浪线包围的字,会加~~删除线~~

引用和代码块

引用,可以方便的用大于号 >开头

这是一个引用
引用的结束是用空行来决定

代码高亮在很多MarkDwon编辑器里同样提供支持,只需要使用三个 “ `加上语言名称,并以同样的标签结束。

//Objective-C
//PHP是最好的语言

printf("Hello World!")

表格和公式

表格也非常方便,另起一行,用|代表需要的列,第二行用:–(居右)、–:(居左)、:–:(居中)来声明列居中方式,一个简单的表格就完成了,看,非常方便吧!

Title1 title 2 titele
这样来说 似乎就是 表格
表格的单列宽度是自适应,并不受语法控制
| Title1     |          title 2 |      titele|
|:-------------------- |----------:|:-----:|
|这样来说|似乎就是| 表格|
|表格的单列宽度是自适应,并不受语法控制|这|样|

在Markdown的引用、表格等内容里,可以同样使用标题、粗体等其他标签.但由于代码亮度的难度,在代码块里不能使

公式对于码农来说似乎并不太重要,用 $ y = y +1 $ 用美元$前后包围起来就是行内公式
如果用两个美元符号包围起来,则变成了整行公式
$$ a = a+b/c $$

链接和图片引用

对于网址,更是简单[]和()的联合使用即能完成一个链接,[]里输入的是链接的标签,()里提供链接地址。

Google 现在不翻墙,就无法访问,所以我们使用 Aol在线 来访问搜索引擎。

[Google](https://www.google.com) 现在不翻墙,就无法访问,所以我们使用 [Aol在线](http://www.aol.com) 来访问搜索引擎。

同样,如果想引入一张图片,也很容易,但稍微麻烦的是,你要知道图片的网址,使用![]()即可完成一个图片的载入
图片

![图片](http://img3.cache.netease.com/photo/0003/2014-06-24/9VGGV2CG00AJ0003.jpg)

如果链接中有括号等Markdown语法识别的特殊字符,我们可以这样使用

![图片][1]
[1]:http://img4.cache.netease.com/photo/0003/2014-06-24/9VGGUVS600AJ0003.jpg

效果如下:

图片

分隔符

至于常用的分隔符也很简单,无论是,还是-,或者_,只要连输三次,即可生成一行的分隔线

分隔符下划线_


分隔符星号*


分隔符小破折号-


复选框

使用- [ ]- [x]可以完成复选框
– [ ] 是
– [x] 否
– [ ] 注意格式是-[间有一个空格,[ ]中有一个空格或一个x(有x时不能有空格)
– [ ] 复选框是不能在印象笔记中勾选的。飞象或其他Markdown编辑器中是可以的。

引用、脚注和目录

  • 使用[^标签]是脚注,与其对应的是在文档显示在底部的脚注。会自动编号,同时在Markdown编辑器中查看时支持点击跳转。 例1
  • 使用[内容][序号]两个连续的方括号定义的,是引用链接,可以文档结尾,统一使用[序号]:URL的方式,定义引用的链接,例如标签
  • [TOC]关键字,字义目录,在需要使用的地方,加上[TOC]即可使用。
  • 限于印象笔记对语法解析的支持,引用和脚注等功能,无法在印象笔记中直接使用。

使用Markdown语法,可以非常流畅的写出顺心的文字,同时它的语法又简单到五分钟内完成。相信经过这几分钟的笔记 ,你也能学会Markdown了!

流程图&时序图(UML)

  • 流程图/时序图是马克大象新版本增加的高级Markdown语法,可以方便的画出流程图和时序图。
  • 流程图/时序图采用JS和CSS加载实现,所以它采用的是类似编程语言的写法定义。
  • 流程图:首先用标签定义流程图里的元素,然后用语法来画流程
    • 使用与代码块一样的三个“ 来标记流程图&时序图的开始和结束 ,流程图是flow标签,时序图是sequence`标签。
    • 流程图定义:
      • 首先定义流程图中各模块的名称,格式如下: tag => type: Title
        • 其中,type类型有start开始、 end结束、 operation过程、 condition分支等。
        • 定义完各模块后,使用tag->tag的方式,定义流程。分支tag名后,用括号标明分支选择的定义,如 tag(yes)->tag。

例:

k=>start: 开始
e=>end: 结束
o=>operation: 处理
c=>condition: 选择

k->c
c(yes)->o
c(no)->e
o->e
```flow
k=>start: 开始
e=>end: 结束
o=>operation: 处理
c=>condition: 选择

k->c
c(yes)->o
c(no)->e
o->e
```
- 时序图定义:
    - 时序图使用`sequence`为语法标签
    - 按顺序定义序列,使用 Title-> Title `:`Title,定义一个序列,`->`与标签前后不要留空格。
    - `Note` `right|left` `of ` title为过程标签
    - Title `-->` Title为虚线序列

例:

Tag1->Tag2: 第一序列
Note left of Tag1: 我在想想
Tag2-->Tag1: 虚线序列
```sequence
Tag1->Tag2: 第一序列
Note left of Tag1: 我在想想
Tag2-->Tag1: 虚线序列
```

与大象笔记(Evernote)相关

  • 笔记的第一个标题,即为大象中笔记的标题
  • 在笔记开头(第一个标题下),使用@+()即可选择保存至那一个笔记本,后面可加[]来增加标签
  • Markdown语法的笔记保存是单向的,即马克飞象中的笔记可以同步到大象中,但大象中不能对马克飞象生成的笔记进行修改。只有通过点击大象中笔记右上方的红色标签来返回马克飞象修改。

  1. 示例脚注.
    1:https://github.com/fletcher/MultiMarkdown/wiki/MultiMarkdown-Syntax-Guide#footnotes 

Comments

No comments yet. Why don’t you start the discussion?

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注