首页 > Java > Markdown 基本语法介绍

Markdown 基本语法介绍

Markdown 是我很喜欢的一个轻量级标记语言,但也因为不常写,所以有些语法记得不是很清楚,经常写的时候需要查一些资料,所以这次就把一些简单的常用的语法做个笔记。

在介绍 markdown 语法之前,先写一点废话。

一. markdown是什么?

简单的一句话就是,Markdown 可谓是程序员必备的一种写作格式!你还在用 word 写文档么?简直 low 爆了,赶紧抛弃,从现在开始,立刻,马上,学习下 markdown。

二. markdown有什么好处?

简单说,语法简单、再也不用专注排版、兼容 html、还有其他的的很多很强大的功能(这么厉害,你的博客为啥不用?因为 WordPress 原生编辑器不支持 markdown,也一直没有安装第三方的插件,所以就没有)

三. markdown 编辑器有哪些?

个人最喜欢的开发工具是,GitHub 出品的 Atom,自带提示;之前也在 Windows 下用过 markdownpad,也还行,mac 下有很多人推荐 mou,另外据说 Sublime 也不错,还有一些在线工具据说也不错。

四. markdown 语法

1. 标题 1 到 6:#1 到 #6

代码示例:


# 标题一
### 标题三

2. 区块:>

代码示例:


> 这是区块
>
> 第二行区块

3. 斜体:*斜体*

代码示例:


*斜体*

4. 加粗:**加粗**

代码示例:


**该部分加粗**

5. 删除线:~删除线~

示例代码:


~~这是加删除线的文字~~

6. 换行和分段

换行:只需在行末加两个空格键和一个回车键即可换行。快捷键:control + 回车键
分段:段落之间空一行即可

7. 无序列表:*、+、-

代码示例:


* 第一个
* 第二个

多一行

* 第三个
  + 嵌套一
  + 嵌套二

8. 有序列表:数字 + 点号

代码示例:


1. 第一个
1. 第二个

注:
1. 如果段的开头就是数字 + 点号,则在点号之前加 \ 进行转义;
2. 如果想在列表的单项内使用代码,则代码之前必须是 2个 Tab 或者 8个空格 ;
3. 如果想在列表的单项内使用区块,则>之前必须是 1个 Tab 或者 4 个空格, 并且前后各一个空行;

9. 代码块:

示例代码:三个上分点


```java

这是代码

```

10. 行内代码:

示例代码:


来个`HelloWorld`吧

11. 行内链接

示例代码:


这是[BridgeLi's Blog](https://www.bridgeli.cn "BridgeLi's Blog")。

12. 参考链接

示例代码:


这是[BridgeLi's Blog][1]。
[1]: https://www.bridgeli.cn "BridgeLi's Blog"

13. 自动链接

示例代码:


<https://www.bridgeli.cn>

14. 图片,图片和链接一样

示例代码:


下面是 BridgeLi 的头像:

 ![BridgeLi](https://secure.gravatar.com/avatar/1f76f8c0aac21a192a62378cdff08996?s=96&d=mm&r=g "BridgeLi")

15. 分割线:三个以上的*、-、_

示例代码:


****
----
____

16. 表格

示例代码:


表头|表头|表头
---|:--:|---:
内容|内容|内容
内容|内容|内容

第二行分割表头和内容。
- 有一个就行,为了对齐,多加了几个
文字默认居左
-两边加:表示文字居中
-右边加:表示文字居右
注:原生的语法两边都要用 | 包起来。此处省略

17. 代办列表: 表示列表是否勾选状态(注意:[ ] 前后都要有空格)

示例代码:


- [ ] 不勾选
- [x] 勾选

18. 流程图,来个简单的,实际上 md 支持:流程图、时序图和甘特图

示例代码:


```graph
graph TD;
    A-->B;
    A-->C;
    B-->D;
    C-->E;
    E-->F;
    D-->F;
    F-->G;
```

最后说一点点八卦,之前看耗子叔的文章,markdown 是 Aaron Swartz 十几岁的时候开发的,一个称之无愧的天才,具体怎么天才可以参看耗子叔的文章,写的非常好。

参考链接:
1. https://www.diguage.com/archives/28.html
2. https://github.com/riku/Markdown-Syntax-CN

全文完,如果本文对您有所帮助,请花 1 秒钟帮忙点击一下广告,谢谢。

作 者: BridgeLi,https://www.bridgeli.cn
原文链接:http://www.bridgeli.cn/archives/547
版权声明:非特殊声明均为本站原创作品,转载时请注明作者和原文链接。
分类: Java 标签: , ,
  1. 本文目前尚无任何评论.

请输入正确的验证码