Markdown 介绍
- Markdown 是一个 轻量级 高效率 的标记语言
- 轻量级标记语言,
2004
年被John Gruber
创造, 它允许人们“使用易读易写的纯文本格式编写文档”, Markdown 最重要的设计就是可读性, Markdown 可以选择性的转换为HTML
文档格式, 很多网站目前都使用了Markdown
或者其变种,例如Github
、简书等大型社区。
Markdown 使用场景
- 学习笔记
- 演讲稿
- 写书(侧重于技术相关的 内容非常适合)
- 个人笔记
- 文章博客
- 教学讲义
- 说明文档
- 电子邮件
Markdown 实时预览编辑器
- dillinger
- 马克飞象
- 简书
- MarkdownPad
- Sublime Text
- 配合 Markdown Preview 插件
- Webstorm
- 配合插件
- gitbook
实时预览工具只是为了达到所见即所得的效果而已, 适合初学者学习 Markdown
, 我们真正在进行写作的时候,其实是不需要实时预览的, 因为 Markdown 标记语言本身已经足够清晰了。
Markdown 安装和配置编写预览环境(sublime)
- 按下键
Ctrl+Shift+p
调出命令面板,找到Package Control: install Pakage
这一项。搜索markdown preview
,点击安装。 Markdown Preview
较常用的功能是preview in browser
和Export HTML in Sublime Text
,前者可以在浏览器看到预览效果,后者可将markdown
保存为html
文件。preview in browser
据称是实时的,但是实践上还是需要在st
保存,然后浏览器刷新才能看到新的效果,好在markdown
写得多的话也不需要每敲一行看一次效果。
Webstorm
- 打开
webstorm
,File-->Setting-->输入plugin-->Install JetBrains plugin...-->输入markdown-->
点击右边的Install
,安装完,重启webstorm
。
Visual Studio Code
Visual Studio Code
自带markdown
预览,所以不需要安装插件,不过可以安装语法高亮主题
Sublime
- MarkdownEditing 主题、自动补齐等功能
- MarkdownPreview 在浏览器预览
- MarkdownTOC 自动生成导航
- Table Editor 自动表格编辑
- packagecontrol Sublime 的插件生态系统网站
只要有写作的地方,都可以使用 Markdown
来书写。
Markdown 标题书写
1 | # 一级标题 |
Markdown 列表书写语法
无序列表
- 一级列表建议使用
-
- 二级列表建议使用
+
- 三级列表建议使用
*
- 三级列表建议使用
- 二级列表建议使用
1 | - 一级标题 |
有序列表
- 有序列表直接使用序列加一个点开头, 然后加一个
- 有序列表嵌套无序列表
- 有序列表中嵌套无需列表
+ 有序列表中嵌套无需列表
1 | 2. 有序列表嵌套无序列表 |
- 有序列表嵌套有序列表
- 有序列表嵌套有序列表
- 有序列表嵌套有序列表
- 有序列表嵌套有序列表
1 | 3. 有序列表嵌套有序列表 |
使用建议
无论是有序列表还是无序列表,如果就写一级列表不嵌套就可以紧凑写到一起即可,如果嵌套多级列表最好在列表项之间只用空行隔开
Markdown 图片链接书写语法
Markdown 图片书写语法
![图片](http://blog.ihoey.com/img/img.jpg)
Markdown 链接书写语法
[链接](http://blog.ihoey.com)
引用
> 例如这样
例如这样
粗体与斜体
Markdown
的粗体和斜体也非常简单,用两个*
包含一段文本就是粗体的语法,用一个*
包含一段文本就是斜体的语法
1 | **这里是粗体** |
表格
1 | | 表头 | 表头 | 表头 | |
表头 | 表头 | 表头 |
---|---|---|
左对齐 | 居中对齐 | 右对齐 |
左对齐 | 居中对齐 | 右对齐 |
左对齐 | 居中对齐 | 右对齐 |
代码框
由三个 ` 反引号包裹, 行内代码在代码前后加一个 ` 反引号
锚点
1 | ## 0. 目录{#index} |
分隔线
1 | * * * |
显示效果都一样: