Markdown语法

本文主要内容包括:markdwon的基本语法和使用技巧。

相关文档


  • 创始人 John Gruber 的 Markdown 语法说明
  • Markdown 中文版语法说明
  • Html特殊符号

概述


宗旨

易读易写

编辑工具

  • Mou
    Mac OS X 系统可以使用,支持实时预览功能
  • Atom
    多端可以使用,就是效率很低。有时候很卡。

  • Web端使用编辑也是不错的选择。可以保存在云端。

兼容 HTML

  • 区块元素(
     

    )

    这是一个普通的段落。
    
    *Hello* Word
    这是另外一个段落。 这是一个普通的段落。
    HelloWord

    这是另外一个段落。
  • HTML 区块标签间的 Markdown 格式语法将不会被处理
  • 行内标签( )可以随意使用
  • 可以直接使用
百度

百度

  • 特殊字符自动转换
      AT&T
      ©
    
    AT&T
    ©

基本符号


  • *,-,+ 3个符号效果都一样,这3个符号被称为Markdown符号
  • 空白行表示另起一个段落
  • `是表示inline代码,tab是用来标记 代码段,分别对应html的code,pre标签

区块元素


段落和换行

段落是由前后一个以上的空行产生的,普通段落不该用空格或制表符来缩进。

标题

  • Setext 形式

    这是 H1
    =============
    这是 H2
    -------------
    
  • atx 形式

    # 这是 H1
    ## 这是 H2
    ###### 这是 H6
    

区块引用 Blockquotes

> 这是一个区块引用
  Markdown 也允许你偷懒只在整个段落的第一行最前面加上 >
>> 区块引用可以嵌套
>>> 区块引用可以嵌套  
>>> - 这是第一行列表项。
>>> - 这是第二行列表项。

>> 区块引用可以嵌套

> 区块引用可以嵌套

这是一个区块引用
Markdown 也允许你偷懒只在整个段落的第一行最前面加上 >

区块引用可以嵌套

区块引用可以嵌套

  • 这是第一行列表项。
  • 这是第二行列表项。

区块引用可以嵌套

区块引用可以嵌套

列表

无序列表使用星号、加号或是减号作为列表标记:

  *   Red
  -   Green
  +   Blue  
  • Red
  • Green
  • Blue

有序列表则使用数字接着一个英文句点

1. Bird  
  第二段  
  第三段

2. McHale
  > 这是一个区块引用
  > 这是一个区块引用
3. Parish
4. 一列表项包含一个列表区块:  
  <代码写在这>
1986. 有序列表前面的序号不起作用
1986\. 避免这种`数字-句点-空白`生成列表
  1. Bird
    第二段
    第三段

  2. McHale

这是一个区块引用
这是一个区块引用

  1. Parish
  2. 一列表项包含一个列表区块:
    代码写在这
  3. 有序列表前面的序号不起作用
    1986. 避免这种数字-句点-空白生成列表

代码区块

markdwon语法

缩进 4 个空格或是 1 个制表符

这是一个普通段落:

    这是一个代码区块。

      import java.io.*;

这是一个普通段落:

这是一个代码区块。

import java.io.*;
  
  `这是一个代码区块`

这是一个代码区块


'''
这是一个代码区块
'''

  这是一个代码区块
html方式

 

分隔线

  ***
  * * *
  ---
  - - -




表格(扩展的markdown才支持)

注意冒号是对齐方式

| Tablees    | Are           | Coll  |
| ----------:|:-------------:|:------|
| col 3 is   | right-aligned | $160  |
| col 2 is   | centered      | $12   |
| col 2 is   | centered      | $12   |
Tablees Are Coll
col 3 is right-aligned $160
col 2 is centered $12
col 2 is centered $12

流程图

参考

  st=>start: Start
  i=>inputoutput: 输入年份n
  cond1=>condition: n能否被4整除?
  cond2=>condition: n能否被100整除?
  cond3=>condition: n能否被400整除?
  o1=>inputoutput: 输出非闰年
  o2=>inputoutput: 输出非闰年
  o3=>inputoutput: 输出闰年
  o4=>inputoutput: 输出闰年
  e=>end
  st->i->cond1
  cond1(no)->o1->e
  cond1(yes)->cond2
  cond2(no)->o3->e
  cond2(yes)->cond3
  cond3(yes)->o2->e
  cond3(no)->o4->e

插入LaTeX公式

参考

  • 使用MathJax引擎

使用Tex写公式。$$公式$$表示行间公式,本来Tex中使用(公式)表示行内公式,但因为Markdown中\是转义字符,所以在Markdown中输入行内公式使用\(公式\),如下代码:

  $$x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}$$
  \\(x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}\\)

$$x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}$$
\(x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}\)

区段元素


强调

*斜体* _斜体_
**粗体** __粗体__
~~删除线~~
下划线
上标2
下标2

斜体 斜体
粗体 粗体
删除线
下划线
上标2
下标2

链接

  • 行内式

    这是一个[行内式的链接](http://tech.xchance.xyz "可选的title")
    这是一个[相对路径的连链接](/about "可选的title")
    

    这是一个行内式的链接
    这是一个相对路径的连链接

  • 参考式
    这是一个[参考式的连接] [1]
    [1]: http://tech.xchance.xyz "Github 个人主页"
    [2]: "Github 个人主页"
    [3]: http://tech.xchance.xyz 'Github 个人主页'
    [4]: http://tech.xchance.xyz (Github 个人主页)
    参考式的连接
    隐式链接标记:[Google Address][]
    [Google Address]: http://google.com/

    [Google Address][]
    [Google Address]: http://google.com/
    [id]: http://tech.xchance.xyz

  • 简写Url

    
    
    

    http://tech.xchance.xyz
    [email protected]

图片

类似链接方式同样支持行内式参考式
hexo好像不支持可选文字

  ![Alt text](http://tech.xchance.xyz/favicon.ico)
  ![Alt text](http://tech.xchance.xyz/favicon.ico)
  ![Alt text][id]
  [id]: url/to/image  "Optional title attribute"
Alt text

Alt text

注脚

原始Markdown语法好像不支持,不过有些Blog是支持的

  这是一个注脚[^footer]
  [^footer]: 这是一个注脚

这是一个注脚 [1]

页内跳转

  定义锚点:  hello world 
  使用锚点: [hello](#jump)

定义锚点: hello world
使用锚点: hello

技巧


  • 使用两个以上的空格然后回车插入
    标签
  • 特殊字符需要\字符来转义:
    \ ` * _ {} [] () # + - . !
  • 如果要在代码区段内插入反引号,你可以用多个反引号来开启和结束代码区段
  代码块中插入反引号:`` ` ``

代码块中插入反引号:`

  • 段首缩进技巧:
    切换到全角模式下(一般的中文输入法都是按 shift + space)输入两个空格就行了
  • 文章中插入注释的话,可以使用``

名词解释


空行 显示上看起来像是空的,便会被视为空行。比方说,若某一行只包含空格和制表符,则该行也会被视为空行


  1. 这是一个注脚 ↩

你可能感兴趣的:(Markdown语法)