[MarkDown] MarkDown语法小结

特殊字符自动转换

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

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

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


段落和换行

一个 Markdown 段落的前后要有一个以上的空行。普通段落不该用空格或制表符来缩进。如果想在段前加缩进 &emsp;是一个中文字符 &ensp;是半个中文字符 &nbsp;是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 语法,包括标题、列表、代码区块等:

这是一个标题。

  1. 这是第一行列表项。
  2. 这是第二行列表项。

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


列表

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

* Red
+ Green
- Blue

显示为

  • Red
  • Green
  • Blue

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

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

  1. Red
  2. Green
  3. Blue

</br> 列表项目标记通常是放在最左边,但是其实也可以缩进,最多 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个空格或者一个制表符

  1. 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.
  2. 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应该显示的代码,输 & 就会转换成 &amp;,显示为 & ,也就是输什么显示什么。

代码区块中 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` ``

代码内可以直接放入 `<` `>` `&` 符号

另外还可以设置代码高亮,根据代码类型来选择,输入格式为:
```` 
```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 |

效果:


github 特有的特性

复选框列表

在列表符号后面加上[]或者[x]代表选中或者未选中情况

  • [x] C
  • [x] C++
  • [x] Java
  • [x] Qt
  • [x] Android
  • [ ] C#
  • [ ] .NET

效果如图:

emoji表情

Github的Markdown语法支持添加emoji表情,输入不同的符号码(两个冒号包围的字符)可以显示出不同的表情。

比如:blush:,可以显示

更多表情符号可以从这里找。

有待补充

其实在haroopad左侧有一个 Quick Markdown 的选项,里面还有不少没用过的命令,看名字大概能猜出意思,这个往后慢慢研究再补充吧。

参考

Markdown 语法说明 某人的Github

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏LeoXu的博客

Flex笔记_MX DataGrid、列表和树

columnCount、columnWidth、dataProvider、iconField、iconFunction、labelField、labelFun...

12620
来自专栏专业duilib使用+业余界面开发

duilib创建自定义控件

37050
来自专栏前端杂货铺

typeof的一些兼容性问题

typeof存在一些兼容性的问题,在IE6,7,8中的DOM和BOM元素及其对象上的方法的判定会出现误差,在safari上对NodeList实例 的判定,对Ex...

359150
来自专栏AhDung

【C#】使用IExtenderProvider为控件添加扩展属性,像ToolTip那样

- 文中的“控件”一词是广义上的说法,泛指包括ToolStripItem、MenuItem在内单个界面元素,并不特指继承自Control类的狭义控件

11620
来自专栏瓜大三哥

matlab GUI基础1

GUI编程开发 1.句柄图形 是一种面向对象的绘图系统。这些细节一般隐藏在图形M文件的内部,用户通过句柄图形可以定制图形的许多特性,这是使用高级绘图函数无法实现...

31580
来自专栏大数据钻研

献给前端的小伙伴,祝大家面试顺利!

HTML相关问题 1.XHTML和HTML有什么区别 HTML是一种基本的WEB网页设计语言,XHTML是一个基于XML的置标语言 最主要的不同: XHTM...

31150
来自专栏进击的君君的前端之路

定时器

20060
来自专栏Java帮帮-微信公众号-技术文章全总结

Web-第四天 jQuery学习

jQuery是一个JavaScript框架。它兼容CSS3,还兼容各种浏览器。文档说明很全,应用详细,成熟插件多。

17240
来自专栏雪地二货笔记库

vue学习笔记10-组件

之后就可以在html中<tagName></tagName>来使用它。 自定义组件也分为全局和局部两种,全局可以在任何实例中使用,而局部只有注册后才能使用。 全...

14210
来自专栏BestSDK

“Excel格式”最风骚玩法,炫技加薪就靠它了

话不多说直接上干货! 001 自定义格式概述 01 调出单元格格式对话框 选中需要设置格式的单元格,按「CTRL+1」快捷键打开「设置单元格格式」对话框。 在对...

38630

扫码关注云+社区

领取腾讯云代金券