Markdown基本语法教程和编辑器选择

初学Markdown,简单总结一下语法和编辑器的选择。

# Markdown是什么?

Markdown (opens new window) 是一种是一种轻量级的标记语言,它以纯文本形式编写文档,并最终以HTML格式发布。它易读、易写、易更改,兼容HTML,跨平台,常在Blog中使用,现在很多电子邮件中也使用了Markdown。

# Markdown编辑器如何选?

这取决于用什么系统,用何种方式编辑,比较推荐能够分屏实时预览的编辑器,“所见即所得”没有代码感,一般会不习惯:

多平台

  • Typora (opens new window) 简洁强大,不支持分屏实时预览,但可以通过Ctrl+/切换视图,并且在预览模式下有很多小惊喜。不论是快捷键还是交互体验都做的非常好,强力推荐。不过有个小缺点:在源代码视图中没法打开文件视图窗口。

  • Atom (opens new window) 较为美观方便 (除了图标) ,按下Ctrl+Shift+M可以分屏实时预览显示效果。Atom可以用于各种代码,交互尚可,可以扩展中文菜单等(竟然可以找到V社起源游戏.cfg文件的高亮扩展包)。   Windows

  • Markdownpad (opens new window) 笔者同学正在使用的编辑器,支持分屏实时预览,交互尚可。   Mac

  • Mou (opens new window) 界面简洁美观,支持分屏实时预览。其他的编辑器也不少。   Linux

  • Remarkable (opens new window) 它是一个卓越且功能齐全的 Markdown 编辑器,为用户提供了一些令人激动的特性   在线编辑

  • dillinger (opens new window) 漂亮强大,分屏实时预览,支持md, html, pdf 文件导出。支持dropbox, onedrive, github. 来自国外,可能不够稳定。

# Markdown基本语法教程

# 一、标题

  1. 使用1~6个#,空格分隔。√
# 这是一级标题
## 这是二级标题
### 这是三级标题
#### 这是四级标题
##### 这是五级标题
###### 这是六级标题
1
2
3
4
5
6
  1. 使用2个以上连续=-
一级标题
===
二级标题
--
1
2
3
4

# 二、段落

  • 使用1个以上>,可嵌套
> 区块引用
>> 嵌套引用
>>> 三嵌套引用
>>>> 四嵌套引用
1
2
3
4

# 三、分割线

  • 3个以上 *-_ ,可以不连续,建议使用不连续减号-- -避免被识别成标题
---
- - -
***
* * *
___
_ _ _
1
2
3
4
5
6
  • 显示效果:

# 四、斜体、粗体和删除线

  1. 斜体:使用一对*括起来
*斜体*
1
  • 显示效果:

斜体

  1. 粗体:使用一对**__括起来
**粗体**  __粗体__
1
  • 显示效果:

粗体 粗体

  1. 删除线:使用一对~~括起来,注意用空格分隔,否则编辑器中后面的内容无法高亮。
~~WDNMD~~
1
  • 显示效果:

WDNMD

# 五、列表

  1. 无序列表:行首或段落首使用+-,空格分隔。建议使用-
+ 第一行
- 第二行
1
2
  • 显示效果:
  • 第一行
  • 第二行
  1. 有序列表:数字+. 空格分隔正文。
1. Line 1
2. Line 2
1
2
  • 显示效果:
  1. Line 1
  2. Line 2

# 六、代码框

  1. 小代码块:一对` ``
`Code`
1
  1. 单行代码框: 4个以上空格或2次以上Tab
        Code
1
  1. 多行代码框:在2)基础上衍生,或使用一对3~个以上``。使用空格`生成的框可能为矩形(非圆角矩形)

```

Code Line 1
Code Line 2

```

1
2
3
4
5
6
7
8
  • 显示效果:
Code Line 1
Code Line 2
1
2

# 七、链接

  • 参考代码:
[GitHub](http://github.com)
自动生成连接 <http://www.github.com/>
1
2
  • 显示效果:

GitHub (opens new window)

自动生成连接 http://www.github.com/ (opens new window)

# 八、图片

  • 参考链接代码,之前加上!。Blog分享图片需要使用一些工具比如图床,Github也可以但是加载较慢,这里分享一个免费的图床 链接 (opens new window) :
![GitHub set up](http://zh.mweb.im/asset/img/set-up-git.gif)
1
  • 显示效果:

    GitHub set up

# 九、表格

  • 若干-表示分割线,左侧:表示左对齐,右侧表示右对齐,两侧均有表示居中。行与列用|分隔。参考代码:
| Header One     | Header Two     |
| :------------- | :------------- |
| Item One       | Item Two       |
1
2
3
  • 显示效果:
Header One Header Two
Item One Item Two

# 心得

  • 很多编译器会设置快键键或者关联词,比如在Atom中输入c会弹出code,此时按下Tab或者Enter即可快速得到相应符号。

  • 可以收集整理一遍Markdown的语法,过程中就可以熟悉并较为熟练掌握这些语法、符号等。

  • 很多格式之间需要多空一行否则会被前者的格式覆盖。

上次更新: 2021/06/07, 17:06:00