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级标题
  

一级标题

二级标题

三级标题

四级标题

五级标题

六级标题

• 锚点
  其实每一个标题都是一个锚点（移动到某个位置）
  比如 回到顶部

表格

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

• 冒号定义左右对齐：

图片

• 格式一：简单

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

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

<img src="http://yansicing.net3v.net/gitpage/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~");
	}

脚注

• 生成一个脚注[^footnote] [^footnote]: 这里是 脚注 的 内容

公式

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

• 行内公式：$\Gamma(n) = (n-1)!\quad\forall n\in\mathbb N$
• 块级公式：$$ $$ $x = \dfrac{-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

返回顶部