Markdown简明语法

来源:互联网 发布:金融行业 数据安全 编辑:程序博客网 时间:2024/05/16 01:07

在千里码的技能树上了解到Markdown是程序员的必备技能,用了之后发现确实是这样。

我觉得对于我而言以下的语法已经够用了,作为入门是一个不错的选择

目录

在设有标题的段落之前添加

[TOC]

    • 目录
    • 强调
    • 分割线
    • 引用
    • 标题Setext方式
  • 大标题
    • 小标题
    • 标题Atx方式
  • 一级标题
    • 二级标题
      • 三级标题
        • 四级标题
          • 五级标题
            • 六级标题
    • 无序列表
    • 嵌套列表
  • 文字超链Inline方式
    • 图片超链
    • 索引超链Reference方式
    • 自动链接
    • 注释
    • 转义字符
    • 代码块
    • 表格
    • 流程图
    • 时序图
    • 标记

强调

星号与下划线都可以,单是斜体,双是粗体,符号可跨行,符号可加空格

**这是星号的强调**__这是下划线的强调__*这是跨行的强调*_单个是斜体_

这是星号的强调
这是下划线的强调
*这是跨行
的强调*
单个是斜体


分割线

三个或更多-_*,必须单独一行,可含空格

***---


引用

翻译成html就是<blockquote></blockquote>,符号后的空格可不要
> 引用

引用

内层符号前的空格必须要

>引用 >>引用中的引用

引用

引用中的引用


标题:Setext方式

三个或更多

大标题===小标题---

大标题

小标题


标题:Atx方式

# 一级标题## 二级标题### 三级标题#### 四级标题##### 五级标题###### 六级标题

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

我喜欢用Atx方式,因为Setext方式容易和下划线混淆


无序列表

符号之后的空格不能少,-+*效果一样,但不能混合使用,因混合是嵌套列表,内容可超长

- 无序列表- 无序列表- 无序列表- 无序列表:我很长。我也很长!那比一比啊?比就比!我有这么长,你有我长吗?我有这么这么长!好吧,你赢了!+ 无序列表++ 无序列表++ 无序列表+* 无序列表** 无序列表** 无序列表*
  • 无序列表
  • 无序列表
  • 无序列表
  • 无序列表:我很长。我也很长!那比一比啊?比就比!我有这么长,你有我长吗?我有这么这么长!好吧,你赢了!
  • 无序列表+
  • 无序列表+
  • 无序列表+
  • 无序列表*
  • 无序列表*
  • 无序列表*

嵌套列表

-+*可循环使用,但符号之后的空格不能少,符号之前的空格也不能少

- 嵌套列表 + 嵌套列表 + 嵌套列表  - 嵌套列表   * 嵌套列表- 嵌套列表
  • 嵌套列表
    • 嵌套列表
    • 嵌套列表
    • 嵌套列表
    • 嵌套列表
  • 嵌套列表

文字超链:Inline方式

在[]之间写入文字超链的名字,也可以叫提示,()中填入链接就可以了,“”中可以写Tooltips,这个可省略。

[我的孙女叫小芳](http://blog.csdn.net/qq_14998713 "我的孙女叫小芳的博客")

我的孙女叫小芳


图片超链

多个感叹号,Tooltips可省略,要设置大小只能借助HTML标记

![baidu](https://ss0.bdstatic.com/5aV1bjqh_Q23odCf/static/superman/img/logo/logo_white_fe6da1ec.png "百度")

baidu


索引超链:Reference方式

索引,1 2可以是任意字符

[我的博客][1][千里码][2][1]:http://blog.csdn.net/qq_14998713[2]:http://www.qlcoder.com/

我的博客
千里码


自动链接

尖括号

<http://blog.csdn.net/qq_14998713><http://www.jianshu.com/users/dd6c2bed5bff/latest_articles>

http://blog.csdn.net/qq_14998713
http://www.jianshu.com/users/dd6c2bed5bff/latest_articles


注释

用html的注释的方式
<!-- 注释 -->


转义字符

用html的注释
Markdown中的转义字符为\,转义的有:

\\ 反斜杠\` 反引号\* 星号\_ 下划线\{\} 大括号\[\] 中括号\(\) 小括号\# 井号\+ 加号\- 减号\. 英文句号\! 感叹号

\ 反斜杠
` 反引号
* 星号
_ 下划线
{} 大括号
[] 中括号
() 小括号
# 井号
+ 加号
- 减号
. 英文句号
! 感叹号


代码块

用两个```包围代码块,在第一行后面可以跟语言的类型,也可以不加

@requires_authorizationdef somefunc(param1='', param2=0):    '''A docstring'''    if param1 > param2: # interesting        print 'Greater'    return (param2 - param1 + 1) or Noneclass SomeClass:    pass>>> message = '''interpreter... prompt'''

表格

| Item      |    Value | Qty  || :-------- | --------:| :--: || Computer  | 1600 USD |  5   || Phone     |   12 USD |  12  || Pipe      |    1 USD | 234  |
Item Value Qty Computer 1600 USD 5 Phone 12 USD 12 Pipe 1 USD 234

流程图

在代码块里面写,语言类型flow
st=>start: Start
e=>end
op=>operation: My Operation
cond=>condition: Yes or No?
st->op->cond
cond(yes)->e
cond(no)->op

Created with Raphaël 2.1.0StartMy OperationYes or No?Endyesno

时序图

在代码块里写,语言类型sequence
Alice->Bob: Hello Bob, how are you?
Note right of Bob: Bob thinks
Bob–>Alice: I am good thanks!

Created with Raphaël 2.1.0AliceAliceBobBobHello Bob, how are you?Bob thinksI am good thanks!

标记

用两个`号

`标记`

标记


这是我学习使用的一点小的心得,其中借鉴了不少网上的需学习资料

0 0
原创粉丝点击