MarkDown学习实践文档
背景:
Markdown是一种可以使用普通文本编辑器编写的标记语言,通过简单的标记语法,它可以使普通文本内容具有一定的格式。现在各大博客,小说写作,日志记录等等都使用MarkDown来书写,它让写作者关注写作的内容而不用去关注格式和排版,因为只要写作者按照MarkDown的标记语言格式书写,MarkDown插件就会自动为你布局排版。而且用MarkDown格式书写的文档,能轻易的转换为html,pdf,word等格式,且能轻易的发布到网上。MarkDown已成为一种写作方式,本人也已经渐渐的痴迷于这种简洁纯粹的写作方式
概述:
MarkDown 的目标是实现「易写易读」.MarkDown语法受到既有的text-to-HTML格式的的影响,如Setext、atx等,但最大灵感来自于纯文本的电子邮件格式.
优点:
- 易写易读,所见即所得,各大博客,github等支持格式,很实用,且格式高端大气上档次去.
- 用MarkDown编写的文档能够以纯文本形式发布
- 用MarkDown能直接制作静态网页
- 用MarkDown + RStudio实现数学公式输入,方便转换为LaTeX科技文档
- 格式转换方便,Markdown 的文本能方便的转换为WORD,PDF,HTML,电子书等格式文档
- 纯文本,所以兼容性极强,可以用所有文本编辑器打开。
- 让你专注于文字而不是排版。
- Markdown 的标记语法有极好的可读性
以下语法内容摘抄自: http://ibruce.info/2013/11/26/markdown/
作为实践,以下内容均以MarkDown语法的形式书写
1.强调
星号与下划线都可以,单是斜体,双是粗体,符号可跨行,符号可加空
一个人来到田纳西
毫无疑问
*我做的馅饼
是全天下*
最好吃的
一个人来到田纳西
毫无疑问
我做的馅饼
是全天下
最好吃的
2.分割线
三个或更多-_*,必须单独一行,可含空格
3.引用
内层符号前的空格必须要
引用
引用中的引用
4.标题:Setext方式
三个或更多
大标题
小标题
5.标题:Atx方式
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
6.无序列表
符号之后的空格不能少,-+*效果一样,但不能混合使用,因混合是嵌套列表,内容可超长
- 无序列表
- 无序列表
- 无序列表
- 无序列表:我很长。我也很长!那比一比啊?比就比!我有这么长,你有我长吗?我有这么这么长!好吧,你赢了!
7.有序列表
数字不能省略但可无序,点号之后的空格不能少
1. 有序列表
2. 有序列表
3. 有序列表
8. 有序列表
8.嵌套列表
-+*可循环使用,但符号之后的空格不能少,符号之前的空格也不能少
- 嵌套列表
+ 嵌套列表
+ 嵌套列表
- 嵌套列表
* 嵌套列表
- 嵌套列表
9.文字超链:Inline方式
Tooltips可省略
10.图片超链
相对文字连接,多了一个感叹号,Tooltips可省略,要设置大小只能借助HTML标记:
11.索引超链:Reference方式
索引,1 2可以是任意字符
12.自动链接
尖括号
http://ibruce.info
bu.ru@qq.com
需要引用代码时,如果引用的语句只有一段,不分行,可以用 ` 将语句包起来。
如果引用的语句为多行,可以将“`置于这段代码的首行和末行.这个和开头输入TAB或者4个空格,然后放入代码效果一样。
代码引用的案例截图:
13.代码:行内代码
在第一行后指定编程语言,也可以不指定
val s = "hello Markdown"
println( s )
14.代码:段落代码
方式1:以```
置于这段代码的首行和末行
val s = "hello Markdown"
println( s )
方式2:每行文字前加4个空格或者1个Tab
val s = "hello Markdown"
println( s )
15.代码:hexo
可指定编程语言,『』代表左右大括号
{% codeblock [title] [lang:language] [url] [link text] %}
code snippet
{% endcodeblock %}
16.注释
用html的注释,好像只有这样?
<!-- 注释 -->
17.转义字符
Markdown中的转义字符为\,转义的有:
\\ 反斜杠
\` 反引号
\* 星号
\_ 下划线
\{} 大括号
[] 中括号
\() 小括号
\# 井号
\+ 加号
\- 减号
\. 英文句号
\! 感叹号
18.制作待办事项To-do List
- [x] 已经完成事项1
- [x] 已经完成事项2
- [ ] 待办理事项
- [ ] 待办事项1
- [ ] 待办理事务2
19.插入空行
在CSDN中的flowchar.js插件的Markdown中,直接输入<br>
然后回车即为输入一个空行,但是此方法在有道云的mermaid类型Markdown中无效.
<br>
总结
以上为基本编译MarkDown的语法,对于编写小说或者记录日志等以及足够使用.但是如果想要使用更加复杂的功能,如插入表格,流程图等,请查看本人博客
Markdown 免费编辑器
Windows 平台
Linux 平台
Mac 平台
在线编辑器
浏览器插件
- MaDe(Chrome)
高级应用
参考文档:
感谢
2017 …… ,卷起裤管跑,撸起袖子干!