Markdown学习之(1)－实践基本语法文档

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 平台

• MarkdownPad
• MarkPad

Linux 平台

• ReText

Mac 平台

• Mou

在线编辑器

• Markable.in
• Dillinger.io

浏览器插件

• MaDe(Chrome)

高级应用

• Sublime Text 2 + MarkdownEditing / 教程

参考文档:

1. Markdown 语法说明 (简体中文版)

2. markdown简明语法

---

感谢

2017 …… ,卷起裤管跑，撸起袖子干！

yanxiangyfg的专栏 ：　“忠于实践，记录点滴”

---