用markdown写下你的第一个md文档

作者: Scien | 来源:发表于2014-12-21 16:24 被阅读28434次

追溯 markdown 这个词的来源,应该是为了对应编写网页所用的HTML(Hyper Text Markup Language 超文本标记语言)中的 markup,我猜...

markdown 是什么?

同HTML一样,markdown也是是一种标记语言,但与HTML相比简直不能更简单。体现在两个地方:

  • 标记符的 数量,HTML文档的需要用到数量繁多的标记符和CSS 样式来控制排版。而 markdown只需要四个基本的标记符号就能完成。
  • 标记符的 书写。HTML文档的内容需要同时标记开始和结束<html>这是一个网页</html>,markdown文档则只要在开始位置标记即可# 这是一个markdown

markdown 用来干嘛?

主要是用来解决文档快速排版快速读取的问题。当我们需要让文档看起来层次分明,但又想不依赖于像Word这样的重型编辑工具来书写、排版和读取时,markdown易写易读的优势就非常明显了。

并且在我使用一段时间后,发现markdown的编写方式还有助于作者梳理逻辑思路和文章层次。

怎样书写和读取 markdown?

同HTML一样,你可以使用任何一款纯文本编辑工具(如记事本)来编辑和读取包含markdown格式的文本,但只有在一些网站(如简书)或者工具(如有道云笔记)下,才能呈现出更加美观的渲染样式。

当然,markdown也可以使用HTML来添加格式和排版,这意味着,你即可以使用标准的markdown语法,也可以在其中嵌入HTML标记,但只有一小部分标记符会起作用。

markdown 语法

非常简单!

  • 基本符号* - + >

基本上所有的markdown标记都是基于这四个符号或组合,需要注意的是,如果以基本符号开头的标记,注意基本符号后有一个用于分割标记符和内容的空格

  • 标题(从大到小取决于#号的数量)

    • 一级标题 # 一级标题

    • 二级标题 ## 二级标题

    • 三级标题 ### 三级标题

    • 四级标题 #### 四级标题

    • 五级标题 ##### 五级标题
    • 六级标题 ###### 六级标题
  • 引用

这是一个引用样式:> 引用内容

  • 段落

    • 段落以 回车 作为标记。
  • 分隔符

    • 连续输入三个以上的 --- 添加横线分隔符,如下:

  • 列表

    • 使用 * - + 中的任何一个符号加空格就可以创建无序列表,但如我这样的完美主义者可以进一步使用+-来表现层次关系。
* 这是一个无序列表
* 这是一个无序列表
+ 这是一个父无序列表
  - 这是一个子无序列表
  • 使用 数字+点+空格+内容 创建有序列表
1. 这是一个有序列表
2. 这是一个有序列表
  1. 这是一个嵌套有序列表
  2. 这是一个嵌套有序列表
  • 列表可以嵌套,使用时在嵌套列表前按 tab空格 来缩进。如您所见,这篇文章的排版就使用了嵌套列表的样式。

  • 链接

[用markdown写下你的第一个md文档](http://www.jianshu.com/p/de9c98bba332) 
  • 也可以直接用尖括号包含网址的方式<http://www.jianshu.com>来直接构造一个可点击的链接 http://www.jianshu.com

  • 图片

    • 像构造一个链接一样,只需要在前面加!
![图片名称](图片地址)
简书
  • 代码段

markdown常用来编写代码文档,因此文档中引入代码必不可少。

  1. 使用
    ```
    代码段
    ```
    这样的方式来构建一个代码段
    ` 符号在左上角esc键下方,请在半角状态输入
print("这是一个代码段");
  1. 使用 `符号包裹代码构建一个代码块

console.log('这是一个代码块');
一些markdown工具支持更简单的按tab缩进方式

  • 字体样式

    • 倾斜 *倾斜*
    • 加粗 **加粗**
    • 倾斜并加粗 ***倾斜并加粗***
    • 文字删除线 ~~文字删除线~~
  • 表格

    • 使用- |符号把内容分割为你认为合适的表格样式就好。
    • 使用:符号标识对齐。
表头1|表头2|表头3
:----|:-----:|-----:
左对齐|居中对齐|右对齐
表头1 表头2 表头3
左对齐 居中对齐 右对齐
  • 保存

最后将markdown编写的文档存为 .md 格式,就可以用对应的工具查看效果和编辑了。

  • 怎样在简书开始你的第一个markdown?

    1. 首先你要注册一个账号
    2. 然后点击右上角 写文章
    3. 点击右下脚角 设置
    4. 默认编辑器选择 MarkDown编辑器
    5. 最后 新建文章

相关文章

网友评论

  • 辉狼_fish:原来MD排版这么漂亮啊
  • Spe_Rains:设置里面,选择编辑器
  • 蜗牛阿呆:你好,怎么在简书里用md形式编辑呢?我没有找到
    MrDarwin:windows下建议用markdownPad很好用的,不过win10系统需要安装个插件,网上又教程。
    未醒先生: @蜗牛阿呆 在网页版或者客户端的设置中讲markdown设为默认编辑器就OK了,而且网页版的编辑器有实时预览的功能。

本文标题:用markdown写下你的第一个md文档

本文链接:https://www.haomeiwen.com/subject/fpxatttx.html