Markdown基本语法

本文只是Markdown的常用基础语法整理,让你能够快速使用markdown,如果需要使用更高级的功能,请参考markdown语法说明。

标题

支持两种标题的语法,类 Setext和类 atx 形式。

  1. Setext 用底线的形式,利用 =(最高阶标题)和 -(第二阶标题),= 和- 没有数量限制,>=2即可。
    使用Setext的方式1 =====
    使用Setext的方式2 -----------
  2. Atx是在行首插入 1 到 6 个 #,对应到标题 1 到 6 阶,1阶最大,6阶最小
    # H1标题
    ## H2标题
    ### H3标题
    #### H4标题
    ##### H5标题
    ###### H6标题

区块引用

  1. 使用 > 作为引用符号。在每行前添加>例如:
    > Android 4.3 builds on the performance improvements already included in Jelly
    > Bean — **vsync timing**, **triple buffering**, **reduced touch latency**, **CPU
    > input boost**, and **hardware-accelerated 2D rendering** — and adds new
    > optimizations that make Android even faster.

  2. 或者只在整个段落的第一行最前面加上 >,例如:
    > For highest-performance graphics, Android 4.3 introduces support for **OpenGL ES 3.0** and makes it accessible to apps through both framework and native APIs. On supported devices, the hardware accelerated 2D rendering engine takes advantage of OpenGL ES 3.0 to optimize **texture management**and increase **gradient rendering fidelity**.

列表

  1. 无序列表 使用星号(*)、加号(+)或是减号(-)作为列表标记,例如:

* Android
* IOS
* WP

+ Android
+ IOS
+ WP

- Android
- IOS
- WP

2.有序列表 数字接着一个英文句点,数字没有顺序要求,例如:
1. Android
2. IOS
3. WP
或者
10. Android
35. IOS
4. WP
结果都会显示成

  1. Android
  2. IOS
  3. WP

代码区块

Markdown 中建立代码区块很简单,只要 缩进 4 个空格 或是 1 个制表符就可以,例如:

Hello,这是一个代码区块。

一个代码区块会一直持续到没有缩进的那一行。

分隔线

在一行中用三个以上的星号(*)、减号(-)、底线(_),该行内不能再有其他的东西,例如;

* * *
***
********
- - -
_ _ _ _

超链接

  1. 行内式写法
    格式:方块括号后面紧接着圆括号并插入网址链接,如果你还想要加上链接的 title 文字,只要在网址后面,用双引号把 title 文字包起来即可
    [超链接文字]( 超链接Url "链接的 title 文字")
    例如:
    [Android Developers](https://developer.android.com/index.html)
  2. 参考式
    格式:
    [超链接文字][链接的标记]
    [链接的标记]: https://developer.android.com/index.html "Developers"
    这个写法个人感觉没有上一个方便,平时基本行内式就够了,这里就不在多说。

强调

使用星号(*)和底线(_)作为标记强调字词的符号。例如:

只有一个*或者_的,显示斜体效果

*Android Studio*

_Google Developers _

结果
Android Studio

Google Developers

两个*或者_的,显示加粗效果:

**Android Studio**

__Google Developers__

结果
Android Studio

Google Developers

代码

标记一小段行内代码,用反引号(`)把它包起来即可,例如:

`private ArrayList<Map<String, Object>> mData = new ArrayList<Map<String, Object>>();`

图片

  1. 行内式
    格式:一个惊叹号+一个方括号,里面放上图片的替代文字+一个普通括号,里面放上图片的网址
    ![图片的替代文字](图片的网址) 例如:
    ![0.gif](http://upload-images.jianshu.io/upload_images/1179815-886f0e2250cfb959.gif?imageMogr2/auto-orient/strip)
    显示为:
  2. 参考式
    格式:![Alt text][id]
    和超链接相似,不常用。

反斜杠

Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号:
\ 反斜线
\ 反引号* 星号_ 底线{} 花括号[] 方括号() 括弧# 井字号+ 加号- 减号. 英文句点! 惊叹号`

补充

  • 首行空格
    由于markdown不负责实现段首缩进,所以只能手动输入空格,实现首行空格主要有一下几种写法:
  1. &nbsp;
  2. &emsp;
  3. 全角空格,切换到全角模式下(一般的中文输入法都是按 shift + space)输入两个空格即可。

推荐使用第三种方式,简单高效。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容

  • atom编辑器的使用和markdown基本语法 atom介绍 atom是什么 Atom是github内部的编辑软件...
    Haoqian阅读 35,901评论 3 39
  • 1. 标题 Markdown 支持两种标题的语法,类 Setext 和类 atx 形式。 类 Setext 形式是...
    Eva3288阅读 3,134评论 0 0
  • #标题1##标题2###3级标题一级标题===一级标题========二级标题---<&©<####段落引用> T...
    oking阅读 6,321评论 0 1
  • 一. 标题 1.标题的输入以及输出结果 2.下划线生成标题 标题1 标题2 二.引用 在英文半角状态下输入大于号"...
    游离的栖息地阅读 4,704评论 0 2
  • 深夜,插着耳机单曲循环,胡乱敲着键盘,却不知道要写些什么,跨度太大的思维,猝不及防的曾经,突然闯进脑海的你 熟练的...
    兰姑凉阅读 3,836评论 11 7