美文网首页
Markdown——入门指南

Markdown——入门指南

作者: stormlei | 来源:发表于2017-03-19 17:59 被阅读25次
starbucks

版权声明:本文为 stormlei 的原创文章,可以随意转载,但必须在明确位置注明出处!!!

导语:

Markdown 是一种轻量级的「标记语言」,它的优点很多,目前也被越来越多的写作爱好者,撰稿者广泛使用。看到这里请不要被「标记」、「语言」所迷惑,Markdown 的语法十分简单。常用的标记符号也不超过十个,这种相对于更为复杂的 HTML 标记语言来说,Markdown 可谓是十分轻量的,学习成本也不需要太多,且一旦熟悉这种语法规则,会有一劳永逸的效果。

一、认识 Markdown

Markdown 官方文档

这里可以看到官方的 Markdown 语法规则文档,当然,后文我也会用自己的方式阐述这些语法的具体用法。

使用 Markdown 的优点

  • 专注你的文字内容而不是排版样式,安心写作。
  • 轻松的导出 HTML、PDF 和本身的 .md 文件。
  • 纯文本内容,兼容所有的文本编辑器与字处理软件。
  • 随时修改你的文章版本,不必像字处理软件生成若干文件版本导致混乱。
  • 可读、直观、学习成本低。

使用 Markdown 的误区

We believe that writing is about content, about what you want to say – not about fancy formatting.


我们坚信写作写的是内容,所思所想,而不是花样格式。


— Ulysses for Mac

  • Markdown 旨在简洁、高效,也由于 Markdown 的易读易写,人们用不同的编程语言实现了多个版本的解析器和生成器,这就导致了目前不同的 Markdown 工具集成了不同的功能(基础功能大致相同),例如流程图与时序图,复杂表格与复杂公式的呈现,虽然功能的丰富并没有什么本质的缺点,但终归有些背离初衷,何况在编写的过程中很费神,不如使用专业的工具撰写来的更有效率,所以如果你需实现复杂功能,专业的图形界面工具会更加方便。当然,如果你对折腾这些不同客户端对 Markdown 的定制所带来高阶功能感到愉悦的话,那也是无可厚非的

二、Markdown 语法的简要规则

标题

# 一级标题
## 二级标题
### 三级标题

以此类推,总共六级标题。

标题

粗体、斜体、删除线和分割线

Markdown 的斜体、粗体和分割线也非常简单,用一个 * 包含一段文本就是斜体的语法,用二个 * 包含一段文本就是粗体的语法,用三个个 * 包含一段文本就是分割线的语法。

*这里是斜体*

**这里是粗体**

这里是分割线 ***

~~这里是删除线~~

粗体、斜体和分割线

列表

无序列表

- 1
- 2
- 3

有序列表

1. 1
2. 2
3. 3
列表

引用

> 这里是引用

引用

链接和图片

插入链接与插入图片的语法很像,区别在一个 ! 号。

链接为:[]()

图片为:![]()

引用

代码框

如果你是个程序猿,需要在文章里优雅的引用代码框,在 Markdown下实现也非常简单,只需要用两个 ` 把中间的代码包裹起来。

单行:function test() {}

多行:

class ProductsController < ApplicationController
  def index
    @projects = Product.all

    respond_to do |format|
      format.html # index.html.erb
      format.json {render josn: @projects}
    end
  end
end
代码框

表格

表格是我觉得 Markdown 比较累人的地方,例子如下:

|这里是表头|这里是第二列|这里是第三列|
|:-|:-:|-:|
|第二行|第二列|第三列|
|第三行|第二列|第三列|
|第四行|第二列|第三列|
表格

三、相关推荐

工具

相关文章

  • Markdown 测试

    网上的学习资源Markdown——入门指南献给写作者的 Markdown 新手指南markdown官方指南CSDN...

  • markdown的语法

    markdown的语法示例,具体看图Markdown——入门指南

  • Markdown 入门指南

    Markdown 入门指南 目录Markdown 语法的起源Markdown 语法的种类Markdown trad...

  • markdown语法

    参考链接 wowubuntu Markdown——入门指南 learning markdown guide(列表元...

  • 索引

    CoreAnimation/核心动画 Markdown——入门指南

  • Markdown学习指南

    献给写作者的 Markdown 新手指南 Markdown: Basics (快速入门) Markdown 语法说...

  • Markdown语法

    1. Markdown 新手指南2. Markdown 快速入门3. Markdown 完整语法

  • Sublime + Markdown

    简书Markdown 使用指南 认识与入门Markdown Sublime 使用教程

  • 初识Markdown

    Markdown入门指南中文版 和Markdown入门指南初次使用,参考的两篇文章。 一级标题-记录初衷 二级标题...

  • MarkDown使用

    Markdown入门指南中文版 和Markdown入门指南初次使用,参考的两篇文章。 一级标题-记录初衷 二级标题...

网友评论

      本文标题:Markdown——入门指南

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