关于程序员:MarkDown高阶语法手册

原文链接

1. 内容目录

在段落中填写 [TOC] 以显示全文内容的目录构造。

[TOC]

2. 标签分类

在编辑区任意行的列首地位输出以下代码给文稿标签：

标签：数学 英语 Markdown

或者

Tags：数学 英语 Markdown

3. 删除线

应用 ~~ 示意删除线。

这是一段谬误的文本。

4. 注脚

应用 [^keyword] 示意注脚。

这是一个注脚 ¹ 的样例。

这是第二个注脚 ² 的样例。

5. LaTeX 公式

“$”示意行内公式：

质能守恒方程能够用一个很简洁的方程式 $E=mc^2$ 来表白。

“$$”示意整行公式：

$$
\sum_{i=1}^n a_i=0
$$

$$
f(x_1,x_x,\ldots,x_n) = x_1^2 + x_2^2 + \cdots + x_n^2
$$

$$
\sum^{j-1}_{k=0}{\widehat{\gamma}_{kj} z_k}
$$

拜访 MathJax 参考更多应用办法。

6. 增强的代码块

反对四十一种编程语言的语法高亮的显示，行号显示。

非代码示例：

$ sudo apt-get install vim-gnome

Python 示例：

@requires_authorization
def somefunc(param1='', param2=0):'''A docstring'''
    if param1 > param2: # interesting
        print 'Greater'
    return (param2 - param1 + 1) or None

class SomeClass:
    pass

>>> message = '''interpreter
... prompt'''

JavaScript 示例：

/**
* nth element in the fibonacci series.
* @param n >= 0
* @return the nth element, >= 0.
*/
function fib(n) {
  var a = 1, b = 1;
  var tmp;
  while (--n >= 0) {
    tmp = a;
    a += b;
    b = tmp;
  }
  return a;
}

document.write(fib(10));

7. 流程图

示例

st=>start: Start:>https://www.zybuluo.com
io=>inputoutput: verification
op=>operation: Your Operation
cond=>condition: Yes or No?
sub=>subroutine: Your Subroutine
e=>end

st->io->op->cond
cond(yes)->e
cond(no)->sub->io

更多语法参考：流程图语法参考

8. 序列图

示例 1

Alice->Bob: Hello Bob, how are you?
Note right of Bob: Bob thinks
Bob-->Alice: I am good thanks!

示例 2

Title: Here is a title
A->B: Normal line
B-->C: Dashed line
C->>D: Open arrow
D-->>A: Dashed open arrow

更多语法参考：序列图语法参考

9. 甘特图

甘特图外在思维简略。根本是一条线条图，横轴示意工夫，纵轴示意流动（我的项目），线条示意在整个期间上打算和理论的流动实现状况。它直观地表明工作打算在什么时候进行，及理论停顿与打算要求的比照。

    title 我的项目开发流程
    section 我的项目确定
        需要剖析       :a1, 2016-06-22, 3d
        可行性报告     :after a1, 5d
        概念验证       : 5d
    section 我的项目施行
        概要设计      :2016-07-05  , 5d
        具体设计      :2016-07-08, 10d
        编码          :2016-07-15, 10d
        测试          :2016-07-22, 5d
    section 公布验收
        公布: 2d
        验收: 3d

更多语法参考：甘特图语法参考

10. Mermaid 流程图

    A[Hard edge] -->|Link text| B(Round edge)
    B --> C{Decision}
    C -->|One| D[Result one]
    C -->|Two| E[Result two]

更多语法参考：Mermaid 流程图语法参考

11. Mermaid 序列图

    Alice->John: Hello John, how are you?
    loop every minute
        John-->Alice: Great!
    end

更多语法参考：Mermaid 序列图语法参考

12. 表格反对

13. 定义型列表

名词 1
: 定义 1（左侧有一个可见的冒号和四个不可见的空格）

代码块 2
: 这是代码块的定义（左侧有一个可见的冒号和四个不可见的空格）

    代码块（左侧有八个不可见的空格）

14. Html 标签

本站反对在 Markdown 语法中嵌套 Html 标签，譬如，你能够用 Html 写一个纵跨两行的表格：

<table>
    <tr>
        <th rowspan="2"> 值班人员 </th>
        <th> 星期一 </th>
        <th> 星期二 </th>
        <th> 星期三 </th>
    </tr>
    <tr>
        <td> 李强 </td>
        <td> 张明 </td>
        <td> 王平 </td>
    </tr>
</table>


le>
<tr>
    <th rowspan="2"> 值班人员 </th>
    <th> 星期一 </th>
    <th> 星期二 </th>
    <th> 星期三 </th>
</tr>
<tr>
    <td> 李强 </td>
    <td> 张明 </td>
    <td> 王平 </td>
</tr>
ble>

15. 内嵌图标

本站的图标零碎对外开放，在文档中输出

<i class="icon-weibo"></i>

即显示微博的图标：

替换 上述 i 标签 内的 icon-weibo 以显示不同的图标，例如：

<i class="icon-renren"></i>

即显示人人的图标：

更多的图标和玩法能够参看 font-awesome 官方网站。

16. 待办事宜 Todo 列表

应用带有 [] 或 [x]（未实现或已实现）项的列表语法撰写一个待办事宜列表，并且反对子列表嵌套以及混用 Markdown 语法，例如：

- [ ] **Cmd Markdown 开发 **
    - [ ] 改良 Cmd 渲染算法，应用部分渲染技术进步渲染效率
    - [ ] 反对以 PDF 格局导出文稿
    - [x] 新增 Todo 列表性能 [语法参考](https://github.com/blog/1375-task-lists-in-gfm-issues-pulls-comments)
    - [x] 改良 LaTex 性能
        - [x] 修复 LaTex 公式渲染问题
        - [x] 新增 LaTex 公式编号性能 [语法参考](http://docs.mathjax.org/en/latest/tex.html#tex-eq-numbers)
- [ ] ** 七月旅行筹备 **
    - [ ] 筹备邮轮上须要携带的物品
    - [ ] 浏览日本免税店的物品
    - [x] 购买蓝宝石公主号七月一日的船票

对应显示如下待办事宜 Todo 列表：

• [] Cmd Markdown 开发

  • [] 改良 Cmd 渲染算法，应用部分渲染技术进步渲染效率
  • [] 反对以 PDF 格局导出文稿
  • [x] 新增 Todo 列表性能 语法参考

  • [x] 改良 LaTex 性能

    • [x] 修复 LaTex 公式渲染问题
    • [x] 新增 LaTex 公式编号性能 语法参考

• [] 七月旅行筹备

  • [] 筹备邮轮上须要携带的物品
  • [] 浏览日本免税店的物品
  • [x] 购买蓝宝石公主号七月一日的船票

学习更多编程常识，请关注我的公众号：

代码的路

本文由 mdnice 多平台公布