[MarkDown] MarkDown语法小结

最新推荐文章于 2025-01-17 09:36:05 发布

zhuweideng

最新推荐文章于 2025-01-17 09:36:05 发布

阅读量451

点赞数 1

分类专栏： MarkDown

MarkDown 专栏收录该内容

1 篇文章

订阅专栏

本文介绍了Markdown的基本语法，包括特殊字符转换、段落和换行、标题、区块引用、列表、代码区块、链接、图片、表格等内容，并展示了GitHub特有的复选框列表和emoji表情功能。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

http://www.wossoneri.com/2015/04/24/[MarkDown]%20markdown%E8%AF%AD%E6%B3%95%E5%B0%8F%E7%BB%93/

[MarkDown] MarkDown语法小结

发表于 2015-04-24 | 分类于 Syntax | 暂无评论 | 阅读次数 159

特殊字符自动转换

HTML中，© 可以写成©也可以直接输 ©

HTML中 < 和 & 都要转码但markdown不必，输入& 和 & 都显示 &，< 也一样

4 < 5 输<后面最好加个空格，否则会当起始标签使用
4<5 输字符码<不用考虑这个问题

段落和换行

一个 Markdown 段落的前后要有一个以上的空行。普通段落不该用空格或制表符来缩进。如果想在段前加缩进 &emsp;是一个中文字符 &ensp;是半个中文字符  是1/4中文字符

标题有两种形式
1.用=或者-表示两阶标题，符号数量建议3个以上，紧挨着显示的标题下一行输入

      
       第一阶标题
      
      
       =======
      
      
       第二阶标题显示效果有下划线
      
      
       ---

效果：

第一阶标题

第二阶标题显示效果有下划线

2.开头用#的数量表示1-6阶的标题，结尾可以以任意数量#结尾（包括0个）

#H1#####

##H2有下划线

###H3

####H4

#####H5

######H6

#######H7 超过6个#就是这个样子

区块引用

在每行前面使用> 或者只在段落中第一行前加>

This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.

Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
id sem consectetuer libero luctus adipiscing.

区块引用也可以嵌套，在嵌套的地方加多个>>就好
这里空行可以不加 > 只要前后段落没有其他不加>的段落就不影响效果，自己可以试试

数据结构

树

二叉树

平衡二叉树

满二叉树

引用的区块内也可以使用其他的 Markdown 语法，包括标题、列表、代码区块等：

这是一个标题。

这是第一行列表项。
这是第二行列表项。

给出一些例子代码：
return shell_exec("echo $input | $markdown_script");

列表

支持有序列表和无序列表，就是列表项前面是数字还是点
无序可用 * + - 显示都是点
比如输入

* Red
+ Green
- Blue

显示为

Green

Blue

有序用数字加英文. 数字是几无所谓的生成的html代码是一样的

建议第一个项目最好还是从 1. 开始，因为 Markdown 未来可能会支持有序列表的 start 属性。

Red
Green
Blue

列表项目标记通常是放在最左边，但是其实也可以缩进，最多 3 个空格，项目标记后面则一定要接着至少一个空格或制表符。每一项换行后前面不对齐也没关系，产生的效果还是好的

Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi,
viverra nec, fringilla in, laoreet vitae, risus.
Donec sit amet nisl. Aliquam semper ipsum sit amet velit.
Suspendisse id sem consectetuer libero luctus adipiscing.

如果列表项之间用空格隔开，输出html会给每一项加<p>标签

一个列表项也可以包含多个段落每一项下的段落都必须缩进4个空格或者一个制表符

This is a list item with two paragraphs. Lorem ipsum dolor
sit amet, consectetuer adipiscing elit. Aliquam hendrerit
mi posuere lectus.

Vestibulum enim wisi, viverra nec, fringilla in, laoreet
vitae, risus. Donec sit amet nisl. Aliquam semper ipsum
sit amet velit.
Suspendisse id sem consectetuer libero luctus adipiscing.

如果列表项内的引用需要缩进，在>前面加上缩进，引用就在列表项内显示

A list item with a blockquote:

This is a blockquote
inside a list item

如果要在list中放代码，该区块需要缩进2次即8个空格或2个tab

a list item with a codeblock
```
private void fun(int x){

}
```

代码区块

开头加4个空格或一个tab即可，markdown会在生成的html代码包上 pre code 标签

这是代码区块

一个代码区块会一直持续到没有缩进的那一行（或是文件结尾）。

<div class="footer">
    &copy; 2004 Foo Corporation
</div>

代码区块中的 & 和 < > 符号会自动转成html应该显示的代码,输 & 就会转换成 &，显示为 & ,也就是输什么显示什么。

代码区块中 markdown 语法不会转换，比如

* Red
+ Green
- Blue

分割线

可以在一行用3个以上的

      
      
       * * *  *  **
      
      
       -- ---- --
      
      
       ___ ___ __
      
      
      
      
      
      
       ---
      
      
      
      
       ## 链接
      
      
       链接文字都是用 [方括号] 来标记。分为两种方式：（我直接用<a></a>如何呢）
      
      
       1.	行内式
      
      
      
          只要在方块括号后面紧接着圆括号并插入网址链接即可，如果你还想要加上链接的 title 文字，只要在网址后面，用双引号把 title 文字包起来即可，如：
      
      
      
          This is [an example](http://www.cnblogs.com/rossoneri/ "我的博客园") inline link with title.
      
      
          [This link](http://www.cnblogs.com/rossoneri/) has no title.
      
      
       2.	参考式
      
      
      
          是在链接文字的括号后面再接上另一个方括号，而在第二个方括号里面要填入用以辨识链接的标记，两个括号间可以最多加上一个空格：
      
      
      
          This is [an example] [id] reference-style link.
      
      
      
          接着，在文件的任意处，你可以把这个标记的链接内容定义出来：
      
      
          `   [id]: http://www.cnblogs.com/rossoneri/ "我的博客园"`
      
      
          链接内容定义的形式为：
      
      
          * 方括号（前面可以选择性地加上至多三个空格来缩进），里面输入链接文字
      
      
          * 接着一个冒号
      
      
          * 接着一个以上的空格或制表符
      
      
          * 接着链接的网址
      
      
          * 选择性地接着 title 内容，可以用单引号、双引号或是括弧包着
      
      
      
         下面这三种链接的定义都是相同的：
      
      
       		[foo]: http://example.com/  "Optional Title Here"
      
      
       		[foo]: http://example.com/  'Optional Title Here'
      
      
       		[foo]: http://example.com/  (Optional Title Here)
      
      
      
          请注意：有一个已知的问题是 Markdown.pl 1.0.1 会忽略单引号包起来的链接 title。
      
      
      
       链接网址也可以用尖括号包起来，其中title属性可以换行：
      
      
       	[id]: <http://example.com/>  "Optional Title Here"
      
      
      
       隐式链接标记功能让你可以省略指定链接标记，这种情形下，链接标记会视为等同于链接文字，要用隐式链接标记只要在链接文字后面加上一个空的方括号.
      
      
       如果你要让 "Google" 链接到 google.com，你可以简化成：`[Google co.][]`
      
      
       然后定义链接内容：`[Google co.]: http://google.com/`
      
      
      
       效果如下：
      
      
       [Google co.][]
      
      
       [Google co.]: http://google.com/
      
      
      
         [id]: http://www.cnblogs.com/rossoneri/ "我的博客园"
      
        
      
        
      
      
       下面列出三种写法，推荐参考式，链接放在段落最后写起来会比较清晰。
      
      
      
      
       	参考式1
      
      
           I get 10 times more traffic from [Google] [1] than from [Yahoo] [2] or [MSN] [3].
      
          
      
      
           [1]: http://google.com/        "Google"
      
      
           [2]: http://search.yahoo.com/  "Yahoo Search"
      
      
           [3]: http://search.msn.com/    "MSN Search"
      
      
       ----
      
      
       	参考式2
      
      
            get 10 times more traffic from [Google][] than from [Yahoo][] or [MSN][].
      
           
      
      
            [google]: http://google.com/        "Google"
      
      
            [yahoo]:  http://search.yahoo.com/  "Yahoo Search"
      
      
            [msn]:    http://search.msn.com/    "MSN Search"
      
      
       ----
      
      
       	行内式
      
      
           I get 10 times more traffic from [Google (http://google.com/ "Google") than from [Yahoo](http://search.yahoo.com/ "Yahoo Search") or [MSN](http://search.msn.com/ "MSN Search").
      
      
      
       效果：
      
      
       I get 10 times more traffic from [Google] [1] than from [Yahoo] [2] or [MSN] [3].
      
      
      
         [1]: http://google.com/        "Google"
      
      
         [2]: http://search.yahoo.com/  "Yahoo Search"
      
      
         [3]: http://search.msn.com/    "MSN Search"
      
      
      
       ----
      
      
      
      
       ## 强调
      
      
       两端<font color=red>各</font>用<font color=red>一个</font> `*`或者 `_`包起来是斜体，<font color=red>各</font>用<font color=red>两个</font>包起来是粗体：
      
      
       *single asterisks*
      
      
       _single underscores_
      
      
       **double asterisks**
      
      
       __double underscores__
      
      
      
       如果符号两边都是空白，没有紧贴着文字，将会当普通符号。
      
      
       如果就是要输出符号则要反斜杠`\*` 或者 `\_`
      
      
      
       ----
      
      
       ## 删除线
      
      
       文本两端加上两个`~~`即可
      
      
       ~~删除我~~
      
      
      
       ---
      
      
      
       ## 代码
      
      
       要标记一小段行内代码，用反引号包起来 ` ` `
      
      
       Use the `printf()` function.
      
      
      
       如果要在代码区段内插入反引号，你可以用多个反引号来开启和结束代码区段
      
      
       像这样输入 ``` ``There is a literal backtick (`) here.``

效果为 There is a literal backtick (`) here.

代码区段起始前和结束后都可以放一个空格，方便代码段隔开
比如可以输入

`foo` `` ```

      
       就显示为 `` `foo` ``
      
      
      
       代码内可以直接放入 `<` `>` `&` 符号
      
      
      
       另外还可以设置代码高亮，根据代码类型来选择，输入格式为：
      
      
       ```` 
      
      
       ```java (type)
      
      
       	code here

      
       几种代码效果如下：
      
      
       ```Java
      
      
       public static void main(String[]args){} //Java

      
       int main(int argc, char *argv[]) //C

      
       echo 
       "hello GitHub"
       #Bash

      
       document.getElementById(
       "myH1").innerHTML=
       "Welcome to my Homepage"; 
       //javascipt

      
       string &
       operator+(
       const 
       string& A,
       const 
       string& B) 
       //cpp

图片

也分为行内式和链接式

行内式格式：! + [替代图片的文字，可空] + (路径 title)
链接式格式：! + [替代图片的文字，可空] + [id]
[id]: 路径 title

反斜杠

反斜杠可以输出显示一些符号，支持的有

\   反斜线
`   反引号
*   星号
_   底线
{}  花括号
[]  方括号
()  括弧
#   井字号
+   加号
-   减号
.   英文句点
!   惊叹号

表格

      
       表头1  | 表头2
      
      
       ------------- | -------------
      
      
       Content Cell  | Content Cell
      
      
       Content Cell  | Content Cell
      
      
      
       | 表头1  | 表头2|
      
      
       | ------------- | ------------- |
      
      
       | Content Cell  | Content Cell  |
      
      
       | Content Cell  | Content Cell  |
      
      
      
       | 名字 | 描述          |
      
      
       | ------------- | ----------- |
      
      
       | Help      | Display the help window.|
      
      
       | Close     | Closes a window     |
      
      
      
       表格中也可以使用普通文本的删除线，斜体等效果
      
      
      
       | 名字 | 描述          |
      
      
       | ------------- | ----------- |
      
      
       | Help      | ~~Display the~~ help window.|
      
      
       | Close     | _Closes_ a window     |
      
      
      
       表格可以指定对齐方式
      
      
      
       | 左对齐 | 居中  | 右对齐 |
      
      
       | :------------ |:---------------:| -----:|
      
      
       | col 3 is      | some wordy text | $1600 |
      
      
       | col 2 is      | centered        |   $12 |
      
      
       | zebra stripes | are neat        |    $1 |