史上最实用的markdown 教程

马克飞象 使用笔记

@(林木木的博客) [马克飞象|教程]

Markdown 官方文档

这里可以看到官方的 Markdown 语法规则文档:
+ 创始人 John Gruber 的 Markdown 语法说明

  • Markdown 中文版语法说明

快捷键

强调:斜体粗体 ctrl+I/B
链接:Google[http://www.google.com] ctrl+L
图片:!evernote ctrl+G
笔记本:>@(马克)[马克飞象, make]
标题:#大标题 ####四级标题 ctrl+H
列表:1.有序列表 -无序列表 -[]复选框 -[x]复选框
引用>引用内可以嵌套标题,列表等
重成标题预览:[TOC]
表格:ctrl+alt+T

Col1 Col2 Col3
field1 field2 field3

代码:ctrl+K
行内代码

块状代码

其他快捷键
文档管理 :ctrl+o
最大化编辑器:ctrl+enter
预览文档:ctrl+alt+enter
同步文档:ctrl+s
创建文档:ctrl+alt+n
帮助:ctrl+/

一、标题

”#的数量代表级别,一级为最大标题,逐级减小,总共六级标题,建议在井号后加一个空格,这是最标准的 Markdown 语法”

一级标题

二级标题

三级标题

二、列表

列表分为有序列表和无序列表,
无序列表
- 列表文本前使用 [减号+空格]
+ 列表文本前使用 [加号+空格]
* 列表文本前使用 [星号+空格]

有序列表
- 列表前使用 [数字+空格]
- 和 HTML中一样,可以在符号前加上\来转义,达到以任意数字开始

示例:
- 支持表格、代码块、LaTeX数学公式、目录
- 可以很方便的插入到 Gmail、Evernote
1. 无序可以嵌套有序为从属列表
2. 变成从属列表,重新计数
6. 需要插入其他数值,需要进行转义
4. 没有缩进,是并列的,计数不重新开始
+ 缩进变成从属列表
* 很容易转为 HTML 、PDF 文件

  1. 没有缩进,是并列的,计数递增

三、分页线、换行和段落标记

  • 不分段换行:行末加两个空格,直接回车
  • 分段换行:两个或多个回车(用空行来换行)
  • 分隔符 — 三个以上的 -可以描绘一根分页线 (注意前后要空行)


  • 两个连续星号包围一段文本,就把这段加粗啦

  • 两个单独星号包围一段文本,就让文本倾斜咯
  • 或者用下划线来倾斜
  • 删除线

四、区块引用

我是引用, 换行也需要添加> ,会整体用框格圈起来
我是引用2
如果要在列表内放入引用,用>搭配缩进:

  • 这里是列表

    这里是内嵌引用
    + 这里是引用内部的列表

  • 这样也是同样显示在区块引用里

  • 换行或者缩进也不能逃出区块

    缩进两次,可以分离

五、链接

Markdown 支援两种形式的链接语法: 行内 和 参考 两种形式,两种都是使用角括号来把文字转成连结。title 属性是选择性的,链接名称可以用字母、数字和空格,但是不分大小写
1. 行内链接:
这里是链接名称
这个锚链接[点击跳转到 二、列表](## 二、列表) 另一种方法点击跳转到 二、列表
邮箱:[email protected]
2. 参考形式
参考形式的链接让你可以为链接定一个名称,之后你可以在文件的其他地方定义该链接的内容:
参考名称Google
其他地方定义,参考链接

六、插入图片

! [图片名称] (http://图片网址/ “title”)
Mou icon

七、表格

绘制表格 需要在前后均保留一行空白。由—-|:—-:|—-: 的结构分割表头和表身,请注意上述代码中的:,控制了单列表格的对齐方向。(也可以用 | - | - | - | 的结构,显得更加整洁)

表头1 表头2 表头3
内容1 内容2 内容3
内容 内容 内容
内容 内容 内容

八、代码块

行内代码
用两个将 int sum = b+c描述为一段将背景标红的行内代码
int sum = b + c
用上下的 “` 标记,变成一段灰色的代码块

int sum = b + c

段前空一行,缩进4个空格,然后书写代码,也可以自动转为代码块。
此外,还可以自定义 css 文件,以 “`ruby 的开头描述“这是一段 ruby 代码”,不同的描述可以适配不同的高亮。

九、LaTeX 公式

  • 两边包围一对 $,可以创建行内公式
    • 例如 Γ(n)=(n1)!nN
    • 从0到n 的和 : ni=0ai=i
  • 或者块级公式:
    x=b±b24ac2a

十、HTML代码

在 Markdown 文本中可以直接书写 html 代码,这需要应用的支持(大部分应用都支持这一点,目前发现简书不支持)。区块元素 —— 比如

这个是HTML行
zhege si
佛挡杀佛

必须在前后加上空行与其它内容区隔开,还要求它们的开始标签与结尾标签不能用制表符或空格来缩进。
请注意,在 HTML 区块标签间的 Markdown 格式语法将不会被处理,在HTML区段标签间则是有效的。

十一、流程图

Created with Raphaël 2.1.0 Start My Operation Yes or No? End yes no

十二、时序图:

Created with Raphaël 2.1.0 Alice Alice Bob Bob Hello Bob, how are you? Bob thinks I am good thanks!

提示:想了解更多,请查看流程图语法以及时序图语法。

马克飞象的markdown语法和其它markdown语法的区别:

  • 笔记本和标签 示例:@(示例笔记本)[马克飞象|帮助|Markdown]
  • 使用 - [ ]- [x] 语法可以创建复选框,实现 todo-list 等功能。
  • [ ] 这是马克飞象特有的
  • [X] 在其它的markdown语法的编辑器中都是无法识别的。

  • 马克飞象代码块 在CSDN编辑器和MaHua在线编辑器都是可以呈现代码的样式,但是在MarkdownPad2中却是不可以的。

  • 马克飞象的LaTeX 公式 流程图 以及时序图。在CSDN编辑器是可以正常显示的,但是MarkdownPad2和MaHua在线编辑器都是却是不可以的。

  • 马克飞象的表格。在CSDN编辑器和MarkdownPad2都是可以呈现代码的样式,但是在MaHua在线编辑器中却是不可以的。

  • 印象笔记的笔记内容使用 ENML 格式,基于 HTML,但是不支持某些标签和属性,例如id,这就导致脚注TOC无法正常点击

  • 其它基本的语法目前没有碰到过,如果有不对的地方欢迎指正

推荐阅读与参考

  • 简书如何切换到 Markdown 编辑器
  • Markdown写作浅谈
  • 提供桌面客户端以及离线Chrome App,

你可能感兴趣的:(史上最实用的markdown 教程)