Markdown简明语法教程

Markdown简明语法教程

---

目录

• 特性介绍
  • 常用
  • 表格
  • 图片
  • 列表
  • 代码
  • 脚注
  • 公式
• 浏览器兼容
• 常用Markdown编辑器推荐
• 参考文献

---

特性介绍

• Markdown简洁语法
• 代码块高亮
• 图片链接和图片上传
• LaTex数学公式
• 离线写博客
• 导入导出Markdown文件

---

常用

• 引用
  

Quote写法：> Quote

• 粗体
  
  Bold写法：*Bold*
  

• 斜体
  
  Italic写法：*Italic*
  

• 链接
  
  Link写法：[Link](https://yansicing.github.io/)

• 参考
  
  References Markdown Extra：References [Markdown Extra][2]

• 横线
  
  下划线_或星号*三个以上
  

• 换行
  
  <br> 或 <\br>
  

• 文字高亮显示
  
  将强调部分用 ``包围起来，达到文字高亮显示Highlight
  
  注意不是单引号，而是Tab上方，数字1左边按键（英文输入法）
  

• 普通分级
  
  数字+点+空格

• 圆点符分级
  

• 一级圆点号 ： 星号* + 空格
  • 二级圆点号：tab + 星号* + 空格
    • 三级圆点号：2个tab + 星号* + 空格

• 缩进符分级
  n个 > ：层次n
  

层次一

层次二

层次三

层次四

层次五

• 单行文字空格
  
  单行文字首个空格会被忽略，如果想要显示首行空格，把输入法的半角改成全角输入
  

• 单行文字显示
  
  单行文本显示，在首行加入俩个tab键或四个空格
  

• 多行文字显示
  
  多行文本显示，在首行加入俩个tab键或四个空格
  
  多行文本显示，在首行加入俩个tab键或四个空格
  
  多行文本显示，在首行加入俩个tab键或四个空格
  

• 标题
  
  # n级标题
  

一级标题

二级标题

三级标题

四级标题

五级标题

六级标题

• 锚点
  
  其实每一个标题都是一个锚点（移动到某个位置）
  
  比如 [回到顶部](### 目录)

表格

• 每个格短横线-要大于一个：

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

• 冒号定义左右对齐：

项目	价格	数量
iMac	8390 RMB	1
iPad	2499 RMB	2
iPhone	6199 RMB	3

图片

• 格式一：简单

 ![head](http://yansicing.net3v.net/head.jpg)

• 格式二：(可设置图片尺寸)

<img src="http://yansicing.net3v.net/head.jpg" alt="download-failed" width="100px"  height="100px">

• 插入图片
  

GitHub仓库图片格式：

图片URL格式：https://github.com/ 用户名 / 项目名 / raw / 分支名 / 存放图片的文件夹 / 该文件夹下的图片

网络上图片格式：

在URL后面，加双引号包围的字符串，显示悬停：

图片加超链接格式：文字链接格式 + 插入图片格式 即：
[ ](图片的超链接)

文字悬停，第一种方式：

文字悬停，第二种方式：

列表

• Markdown　Extra 列表语法：
  项目１
  项目２
  : 定义 A
  : 定义 B

项目３

定义 C

定义 D

定义D内容

代码

• 插入代码片段
  
  在代码起始行用三个`标记，Tab键上面的键。语法高亮要在 `之后加上编程语言（忽略大小写）
  

普通写法：

Drawable drawable = ivSystem.getDrawable();//java

高亮写法：

Drawable drawable = ivSystem.getDrawable();//java

• Python:

@requires_authorization
def somefunc(param1='', param2=0):
    '''A docstring'''
    if param1 > param2: # interesting yansicing~
        print 'Greater'
    return (param2 - param1 + 1) or None
class SomeClass:
    pass
>>> message = '''interpreter
... prompt'''

• C:

#include <stdio.h>
	int main()
	{
		printf("Hello yansicing~");
	}

脚注

• 生成一个脚注¹

公式

使用MathJax渲染 LaTex 数学公式，详见math.stackexchange.com，更多LaTex语法参考mathjax-basic-tutorial-and-quick-reference

• 行内公式：$\Gamma (n)=(n-1)!\forall n\in \mathbb{N}$
• 块级公式：$$ $$ $$x=\frac{-b\pm \sqrt{b^2-4ac}}{2a}$$

浏览器

1. 本编辑器对Chrome浏览器支持最完整,建议使用较新版本Chrome
2. IE9以下不支持
3. IE9，10，11存在以下问题
   1. 不支持离线功能
   2. IE9不支持文件导入导出
   3. IE10不支持拖拽文件导入

常用Markdown编辑器推荐

1. Markdownpad
   貌似专业版需要收取一定dollars$，需要序列号自行搜索
2. Markpad
   推荐使用，Microsoft Store也有，完全免费，支持及时效果浏览
3. CSDN
4. Harropad
5. Retext-Download
   简单强大的文本编辑器，可控制输出格式pdf, html等，仅支持Linux（推荐）

参考文献

• knightyun
• Rain_9155

---

返回顶部

---

---

1. 这里是 脚注 的 内容 ↩︎