Markdown 使用教程

前言

  之前常常在 github 中看到 .md 格式的文件,一直没有注意,也不明白为何文本文档的后缀不是 .txt ,后来无心中看到了 Markdown,看到了用这个东西写得一些web界面等特别的规整漂亮,顿时不明觉厉。后来本身学习了一下,感受这个语言确实简洁、美观,现推荐出来供你们学习和玩玩,但愿能对你有用。html

  本文图文并茂,避免了单纯看语法的枯燥和繁琐,其实,学习一门新东西真的其乐无穷!ios

简介  

Markdown 是一种用来文本处理的轻量级 「标记语言」,它用简洁的语法代替排版,而无需像Microsoft的Word同样须要花费大量的时间进行排版、字体设置。它使咱们专心于码字,用「标记」语法,来代替常见的排版格式。Markdown不止能够处理文本,使得文字更美观,还支持图像、表格等的插入,大大方便了咱们的写做。例如此文从内容到格式,甚至插图,一个键盘能够搞定了,无需鼠标!git

  目前来看,支持 Markdown 语法的编辑器有不少,包括不少网站(例如简书)也支持了 Markdown 的文字录入。Markdown 从写做到完成,导出格式为所欲为,你能够导出 HTML 格式的文件用来网站发布,也能够十分方便的导出 PDF 格式,甚至能够利用 CloudApp 这种云服务工具直接上传至网页用来分享你的文章,全球最大的轻博客平台 Tumblr,也支持 Mou 这类 Markdown 工具的直接上传。github

  目前,咱们的 博客园 一样支持了Markdown文本的编辑,具体如何设置请往下看!web

Markdown特色

  • 专一你的文字内容而不是排版样式;
  • 轻松的导出 HTML、PDF 和自己的 .md 文件;
  • 纯文本内容,兼容全部的文本编辑器与字处理软件;
  • 可读,直观。适合全部人的写做语言。

教程

简明教程:

详细教程

博客园配置Markdown编辑器

  1. 进入博客后台
  2. 点击“设置默认编辑器”
  3. 选中 Markdown并保存
  4. 回到随笔界面点击“添加随笔”
  5. 在“Markdown编辑器”中输入相应的代码
    第一步
    第二步

语法

1. 标题

标题经过 # 的个数来进行区分,Mardown总共支持6级标题。
标题chrome

2. 段落 & 换行

2.1. 首行缩进/空格:

  •  : 英文空格(半角)
  •  : 中文空格(全角)
  • 输入法切换至全角,双击 空格 「推荐」
  • 半方大的空白  &#8194
  • 全方大的空白 &#8195
  • 不断行的空白格  &#160

2.2. 强制换行

  连续的字符串,若是你想要换行,每每打“Enter”是无论用的,正确的换行方法为在 「在须要换行的地方插入 >=2 个 空格」ubuntu

2.3. 空行

两种方式:windows

  • 在markdown中加入 >=2 个空行.
  • 使用<br> 【推荐】
      
    mark

3. 列表

在Markdown下,有四种列表:有序和无序;sublime-text

  • 有序列表:采用 1. 2. 3.的形式
  • 无序列表:采用前面加 * - + 的方式,支持多级嵌套
  • 未完成列表:- [ ],每一个符号间均有空格
  • 已完成列表:- [x],注意空格使用
    PS: 符号与文字之间必须有 空格

mark
mark

4. 引用 (Quote)

若须要引入有出处的一段话等,能够采用引用的方式实现,实现方式为在行开始处加入>,以下所示:
mark浏览器

5. 字体设置

  • 粗体
    字符串先后均加上 **
  • 斜体
    字符串先后均加上 *
  • 删除线
    字符串先后各加 ~~
  • ++下划线++
    字符串先后各加 ++
  • == 字体背景色 ==
    字符串先后各加 ==
  • 标记
    字体先后加上 ` (Esc下方的那个键)

mark

6. 分割带

当上下文不属于同一模块或者无甚关联时刻,可使用分隔符进行隔开;分隔符的格式以下:

  • 连续多个-(>=3)
  • 连续多个*(>=3)
  • 连续多个下划线 _ (>=3)
  • PS:以上,分隔符中间能够有空格,但分割行不可有其它字符存在

mark

7. 图片和连接

  • 图片
    ![]() : [图片名称] (图片网络地址)
  • 连接
    []() : [连接名称(可自定义)] (连接地址)

8. 代码块

和程序相关的写做或是标签语言原始码一般会有已经排版好的代码区块,一般这些区块咱们并不但愿它以通常段落文件的方式去排版,而是照原来的样子显示,Markdown 会用制表符来将代码包起来。
代码块一直持续到没有缩进的那一行(或是文件的结尾)

#include <iostrem> 
    using namespace std;  
    int main(int argc, char **argv) {
        cout << "hello,world!";
    }

mark

9. 网址自动转换

Markdown 支持以比较简短的自动连接形式来处理网址和电子邮件信箱,只要是<>包起来, Markdown 就会自动把它转成连接。通常网址的连接文字就和连接地址同样,例如:

这个是个人博客地址:https://home.cnblogs.com/u/Jimmy1988/
个人邮箱地址是:JimmyNie2017@163.com

mark

10. 转义

Markdown 能够利用反斜杠来插入一些在语法中有其它意义的符号,例如:若是你想要用星号加在文字旁边的方式来作出强调效果,你能够在星号的前面加上反斜杠:

*literal asterisks*

Markdown 支持如下这些符号前面加上反斜杠来帮助插入普通的符号:

\ 反斜线
` 反引号
* 星号
_ 下划线
{} 花括号
[] 方括号
() 括弧
# 井字号
+ 加号
- 减号
. 英文句点
! 感叹号

11. 生成目录

  • 前提条件:

    标题的创建是采用MD格式实现的,目录的生成建议放在文本最开始部分(固然也能够嵌入在文中)。

  • 语法

    [TOC],中间不要有空格

  • 注意事项

    目录的生成并非每一个编辑器都支持的,至今我用过的编辑器 有道云笔记是支持的。

mark

12. 表格

mark
表格的作法一般为:

header 1 | header 2
--- |---
row 1 col 1 | row 1 col 2
row 2 col 1 | row 2 col 2

可用`<br>进行单元格内换行; 可是暂时不支持合并单元格


工具推荐

windows平台

Linux平台

Mac平台

浏览器插件

在线编辑器

  • 麻花:支持在线编辑,关键支持VIM命令

高级应用

更多工具


mark

转载连接:http://www.cnblogs.com/Jimmy1988/p/7053875.html

相关文章
相关标签/搜索