常用markdown语法

本文介绍了markdown的基本语法。标准的markdown语法比较简单,本文介绍的是common markdown,基于标准markdown的被大多数网站采用的markdown语法。

代码

行内代码inline code

效果:行内代码inline code,不要使用三个反引号

使用两个```包裹一段代码,可以在之后指定一种语言
```javascript
$(document).ready(function () {
alert(‘hello world’);
});
```

效果

1
2
3
$(document).ready(function () {
alert('hello world');
});

支持的语言如下(依赖不同的解析器)
1c, abnf, accesslog, actionscript, ada, apache, applescript, arduino, armasm, asciidoc, aspectj, autohotkey, autoit, avrasm, awk, axapta, bash, basic, bnf, brainfuck, cal, capnproto, ceylon, clean, clojure, clojure-repl, cmake, coffeescript, coq, cos, cpp, crmsh, crystal, cs, csp, css, d, dart, delphi, diff, django, dns, dockerfile, dos, dsconfig, dts, dust, ebnf, elixir, elm, erb, erlang, erlang-repl, excel, fix, flix, fortran, fsharp, gams, gauss, gcode, gherkin, glsl, go, golo, gradle, groovy, haml, handlebars, haskell, haxe, hsp, htmlbars, http, hy, inform7, ini, irpf90, java, javascript, json, julia, kotlin, lasso, ldif, leaf, less, lisp, livecodeserver, livescript, llvm, lsl, lua, makefile, markdown, mathematica, matlab, maxima, mel, mercury, mipsasm, mizar, mojolicious, monkey, moonscript, n1ql, nginx, nimrod, nix, nsis, objectivec, ocaml, openscad, oxygene, parser3, perl, pf, php, pony, powershell, processing, profile, prolog, protobuf, puppet, purebasic, python, q, qml, r, rib, roboconf, rsl, ruby, ruleslanguage, rust, scala, scheme, scilab, scss, smali, smalltalk, sml, sqf, sql, stan, stata, step21, stylus, subunit, swift, taggerscript, tap, tcl, tex, thrift, tp, twig, typescript, vala, vbnet, vbscript, vbscript-html, verilog, vhdl, vim, x86asm, xl, xml, xquery, yaml, zephir

也可以使用4个空格缩进表示代码块(4空格可以用tab代替,不推荐,不支持语法)

1
2
3
4
1234-对比参照,请不要复制此行
def g(x):
yield from range(x, 0, -1)
yield from range(x)
def g(x):
yield from range(x, 0, -1)
yield from range(x)    

如果不需要高亮,可以指定nohighlight

标题

行首插入 1 到 6 个 # ,与标题以空格隔开,对应到标题 1 到 6 阶
标题行尾的#可加可不加

粗斜体

Markdown 使用星号( * )和底线( _ )作为标记强调字词的符号,一个表示斜体,两个表示粗体,三个表示粗斜体,和文本之间不能有空格,如果前后都有空格,则是普通的文本

链接

[]标记链接文字,后紧接()输入网址即可,还可以在网址后用双引号包裹一个title

1
2
3
This is [an example](http://example.com/ "Title") inline link.

[This link](http://example.net/) has no title attribute.

This is an example inline link.

This link has no title attribute.

可以在链接文字后紧接方括号,生成参考链接。

1
2
This is [an example][1] reference-style link  
This is another [an example][id] reference-style link

This is an example reference-style link
This is another an example reference-style link

之后,在文件末尾指明链接即可。形式为[]紧接冒号,一个以上空格,网址,引号或者括号包裹的title

1
2
[1]: http://example.com/  "Optional Title Here"
[id]: http://example.com/ (Optional Title Here)

用<>可以包裹一段自动链接

1
<http://example.com>

http://example.com

图片

跟链接使用方法相同,唯一的区别是在[]前添加一个感叹号!

换行

两个段落之间空出一行即可达到分段的效果。

只要在当前行未加2个空格,即可新起一行 。

分割线

新起一行输入三个减号-。当前后都有段落时,请空出一行:


列表

-+* 都可以用作无序列表,与内容之间加一个空格

1
2
- item1
- item2
  • item1
  • item2

有序列表为序号.空格后跟内容

1
2
1. item1
2. item2
  1. item1
  2. item2

列表内嵌其它内容,需要缩进4个空格后再书写内容,代码块也一样(不推荐缩进8个空格)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
- title1
1. item1
content

\`\`\`java
//复制时去掉\,因为不同的md解释器问题,识别不好
//这里的缩进都是2空格,也是我md解释器有问题
private String con="this is another code"
\`\`\`
1. item2
section1

section2

- title2

- title3
  • title1

    1. item1
      content

      1
      private String con="this is another code"
    2. item2
      section1

      section2

  • title2

  • title3

引用

大于号+空格+内容表示一个引用

1
> this is qute

this is qute

多个大于号形成引用嵌套

1
2
> qute1
>> qute2

qute1

qute2

引用里嵌套其它内容和代码块的嵌套相似

Song wechat
扫一扫,关注微信公众号,订阅我的博客
扫码领红包,支持走一波