简书markdown教程

1 支持 Markdown 的编辑器

Windows

推荐 Sublime Text 3,强大优雅的编辑器。
MarkdownPad,一款可以直接预览排版效果的编辑器。

Mac

推荐 Ulysess,专注写作的编辑器,功能强大,体验一流。
Macdown,可以预览排版效果。

Linux

推荐 VIM,编辑器之神。当然,Emacs是神的编辑器。
ReText,也可以预览。

Web

推荐简书,有 Markdown 写作/预览模式。
作业部落,功能强大的 Markdown 编辑器。
与其他常用工具配合
在 Firefox 浏览器上,推荐插件 It’s All Text!,可以将网页上的文本框转化为 Markdown 编辑器。
在和 Evernote 配合使用时,推荐使用马克飞象

扩展阅读

《好用的 Markdown 编辑器一览》
欢迎补充,随时更新。

2 Markdown 语法

现在可以在作业部落的左侧窗口中试试看了。无需注册,直接开始输入文字就好。

要事第一

首先需要注意:在 Markdown 中另起一段时,需要多敲一次回车键,来在段落之间添加一个空行。这是与其他常见文档格式的不同之处。
这是因为,在一些 Markdown 解释器中,会把相邻的两行合并成同一个段落。
例如,当我们这样书写时:
这是第一段。
这是第二段。
实际上看到的效果是这样:
这是第一段。这是第二段。
虽然并非所有 Markdown 解释器都会用同样的解释方式,但是为了避免出错,还是多敲一次回车来添加一个空行吧。

标题

Markdown 中,只需要在文本前面加上“#”,就会被认为是加了一个标题。同理,你还可以增加二级、三级、四级、五级标题和六级标题,只需要增加“#” 即可。例如:
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
列表
实际显示的效果是这样的(在不同的环境下显示效果可能会有差异):

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

当你要罗列一些内容时,列表是很有用的工具。为了说明哪些条目属于这个列表,我们需要引入“项目标记”。

列表项目标记通常放在段落开头,后面要跟着一个空格。列表的各个条目之间可以不留空行。

若列表中的条目没有特定顺序时,可以使用 无序列表。加号“+”或减号“-”都可以作为列表标记,后面要跟一个空格。例如:

Red

Green

Blue

或者

Red

Green

Blue

实际显示的效果都是这样的(在不同的环境下显示效果可能会有差异):

  • Red
  • Green
  • Blue

若想在段落前加上数字序号,就需要用到有序列表了。使用数字、一个英文句号和一个空格即可。例如:

  1. Red
  2. Green
  3. Blue

实际显示的效果是这样的(在不同的环境下显示效果可能会有差异):

  1. Red
  2. Green
  3. Blue

删除线

~~ 哈哈哈哈哈哈哈~~

实际效果:

哈哈哈哈哈哈哈哈

图片

Markdown 中可以插入图片,只需要感叹号、方括号和圆括号即可。例如:
![Alt text] (/path/to/img.jpg)
一个英文感叹号 “!” 后紧跟方括号,里面可以写这张图片的说明;再紧跟一对圆括号,里面写这张图片的网址。例如:
![吃面条] (http://upload-images.jianshu.io/upload_images/19107-4a17a25a90d42a5e.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
实际显示的效果是这样的(在不同的环境下显示效果可能会有差异):

吃面条

有些 Markdown 编辑器也支持拖拽插入图片,这就简单多了。例如简书 或者 Ulysses 就有这种功能。

链接

在文档中插入链接的语法和插入图片的语法很像,只是少了最前面的英文感叹号"!"。
在方括号写下链接文字,圆括号写下网址即可。例如:
[好中文的样子] (http://www.jianshu.com/p/d409bb2b5d6c)
实际显示的效果是这样的(在不同的环境下显示效果可能会有差异):
好中文的样子

引用

可以使用">" 标记来引用其他人的言论、书籍或报纸的内容。只需要在段落的第一行最前面加上 > 即可:

”每位作者都应该学习 Markdown。”

实际显示的效果是这样的(在不同的环境下显示效果可能会有差异):

”每位作者都应该学习 Markdown。”

引用可以嵌套,只要根据层次的不同,加上不同数量的 > 即可:

这是第一级引用。

这是第二级引用。

现在回到第一级引用。

实际显示的效果是这样的(在不同的环境下显示效果可能会有差异):

这是第一级引用。

这是第二级引用。
现在回到第一级引用。

在引用的区域内,也可以使用其他的 Markdown 语法,包括标题、列表等:

这是一个标题。

这是第一行列表项。

这是第二行列表项。

实际显示的效果是这样的(在不同的环境下显示效果可能会有差异):

这是一个标题。

  1. 这是第一行列表项。
  2. 这是第二行列表项。

强调

在Markdown中,可以使用 “*”和 “_” (下划线)来表示加粗和倾斜。

在需要斜体的文本左右各加一个“*”或“_” :

**吹吹那热风,听听那冷雨,看哪,好中文的样子。

__吹吹那热风,听听那冷雨,看哪,好中文的样子。

实际显示的效果是这样的(在不同的环境下显示效果可能会有差异):

吹吹那热风,听听那冷雨,看哪,好中文的样子。

吹吹那热风,听听那冷雨,看哪,好中文的样子。

在需要加粗的文本左右各加两个“”或“_” :*

******吹吹那热风,听听那冷雨,看哪,好中文的样子。**

______吹吹那热风,听听那冷雨,看哪,好中文的样子。__

实际显示的效果是这样的(在不同的环境下显示效果可能会有差异):

吹吹那热风,听听那冷雨,看哪,好中文的样子。

吹吹那热风,听听那冷雨,看哪,好中文的样子。

分割线

在 Markdown 中,可以用分隔线来将内容分成不同区域。

只需要连续三个减号"-"或者三个“*”即可。例如:

--- 或 ***

实际显示的效果是这样的(在不同的环境下显示效果可能会有差异):


如何在简书用markdown插入代码

第一:要在简书设置上该为markdown;
第二:是新建文章,记住,若是之前的文章不会生效的;
第三:把输入法切换为英文,之后点击esc键下的那个键,最终结果为

Paste_Image.png

代码引用

需要引用代码时,如果引用的语句只有一段,不分行,可以用 ` 将语句包起来。
如果引用的语句为多行,可以将```置于这段代码的首行和末行。
代码引用的案例截图:

Paste_Image.png

表格

相关代码:

Paste_Image.png

显示效果:(第二行左边加冒号显示效果靠左,右边加冒号显示效果靠右,两边都加冒号显示效果居中,注意:冒号一定要和虚线紧挨着。)

Tables Are Cool
col 3 is right-aligned $1600
col 2 is centered $12
zebra stripes are neat $1

相关代码:

Paste_Image.png

显示效果:

dog bird cat
foo foo foo
bar bar bar
baz baz baz

显示链接中带括号的图片

代码如下:

![][1]
[1]: http://latex.codecogs.com/gif.latex?\prod%20\(n_{i}\)+1

3 常见问题

Q: 我该去哪里下载 Markdown 软件?

A: Markdown 是一种标准而非软件,任何支持 Markdown 语法的编辑器都可以使用,无论是何种操作系统、哪类设备。请看“3 支持 Markdown 的编辑器”,或者问问 Google。



Q:在简书里怎么切换 Markdown?为什么切换了没有反应?

A:建议使用 Chrome 或 Firefox 浏览器。在简书中,点击右上角个人头像-设置,在“常用编辑器”中选中markdown,然后保存。注意一行小字:“切换后对新建文章生效”。然后点击右上角”写新文章“,再点击工具栏右侧倒数第三个按钮“切换到预览模式”,屏幕应该会分成左右两个区域。在左侧区域输入内容、添加标记,右侧就会实时显示 Markdown 效果了。



Q: 为什么我按说明写了标记,但是没法正常显示?
A: 很可能是你误把中文标点当成了英文标点。在 Markdown 中使用标点符号作为标记时,要使用英文标点符号。没关系,人们总会犯这种小错误。



Q: 为什么我写了正确的标记,但是在编辑窗口中看不到任何效果?
A: 许多 Markdown 编辑器都不是所见即所得的——“所见即所得”是指你对格式的修改会马上反映在屏幕上,就像 Word 那样。如果你的编辑器没有没有实时预览功能,就不会看到格式的变化。Macdown简书 都支持实时预览,你需要先打开这个功能,才能看到这些格式标记的效果。



Q: Markdown 可以排版表格吗?
A: 可以,如果你熟练的话,排版表格也会很快。表格的语法请见“Markdown 语法说明(简体中文版)”。



Q: Markdown可以排版数学公式吗?
A: 可以。只要有相应的扩展,Markdown 可以支持LaTeX 公式、甚至画流程图和甘特图。



Q: 标题效果和加粗有区别吗?
A: 看似没有,其实还是有的。这涉及到如何解释 Markdown 标记的问题,一般和 CSS 有关。更多信息,请看“4 扩展阅读”部分。



Q: 加图片时,无 IT 背景人士一般会采用从桌面拖拽的方式。Markdown 支持拖拽吗?
A: 拖拽图片插入文档或上传到网站,不是 Markdown 语法本身的内容。不过有些网站和 Markdown 编辑器支持拖拽方式,例如 Ulysess 和 简书 。



Q: Markdown 正文可以调整字号吗?
A: 同样和解释 Markdown 标记的方式有关。更多信息,请看“4 扩展阅读”部分。



Q: Markdown 段落开头不能空两格,看着很难受啊。有办法解决吗?
A: 办法嘛……若是在自己机器上的 Markdown 编辑器中,也许你可以修改 CSS。若是在 简书 之类网站上,可能只能手工在每段开始前手工添加五个“&n bsp;”了。记得,是“&nb sp;”,字符和字母之间都没有空格。最后的分号也是有必要的哦~


4 扩展阅读

更多关于 Markdown 语法或工具的内容,可以参考:
Markdown 语法说明(简体中文版)
献给写作者的 Markdown 新手指南
Markdown 是定义文章逻辑结构,而非定义样式的。一般来说,Markdown 最终呈现出的样式,是由对应的层叠样式表(CSS)所定义的。如果想要自己调整出想要的样式,可以从 CSS 开始。这里有一份 CSS 教程:《CSS 入门教程》

Markdown 新手手册(本文)

更多内容,请关注专题《GC4WPS03E05-番外》

5 补充

  1. 左右两边加~ :~ 123456 ~
    实际效果:123456
  2. 左右两边加 ·(Tab上边的键): ·123456 ·
    实际效果:123456
    • 父类的无序标号

      • - 横线前面空两个空格,后面空一个空格,出现小白圈
时间: 2024-07-30 06:04:39

简书markdown教程的相关文章

简书-markdown

标题 这是最为常用的格式,在平时常用的的文本编辑器中大多是这样实现的:输入文本.选中文本.设置标题格式. 如: # 一级标题 ## 二级标题 ### 三级标题 #### 四级标题 ##### 五级标题 ###### 六级标题 注:# 和「一级标题」之间建议保留一个字符的空格,这是最标准的 Markdown 写法. 你可以你的编辑器中尝试输入这六级标题,可以参考下方的截图: 一级标题至六级标题 列表 Markdown 中,只需要在文字前面加上 - 如: - 文本1 - 文本2 - 文本3 有序排列

仿简书MarkDown编辑器可同步滚动

模仿简书的MarkDown编辑器,使用Angular8写的示例 1.支持同步滚动 编辑的过程中,右侧预览界面会同步滚动.滚动右侧预览界面,左侧编辑区也会同步滚动哦 2.支持语法高亮 如下: using System.IO.Compression; #pragma warning disable 414, 3021 namespace MyApplication { [Obsolete("...")] class Program : IInterface { public static

简书 markdown 代码高亮标记

SyntaxHighlight language language_key 1C 1c ActionScript actionscript Apache apache AppleScript a pplescript AsciiDoc asciidoc AspectJ asciidoc AutoHotkey autohotkey AVR Assembler avrasm Axapta axapta Bash bash BrainFuck brainfuck Cap'n Proto capnpro

博客园不支持Markdown语法,新博客将发在简书...

由于博客园博文编辑界面不支持Markdown语法,发在其它平台的博客很难轻松复制过来... 未来新博客将只发在简书里,虽然也很少写博客哈哈... 我的简书个人主页:http://www.jianshu.com/u/f8590867dc2a

献给写作者的 Markdown 新手指南 - 简书

body { font-family: 微软雅黑,"Microsoft YaHei", Georgia,Helvetica,Arial,sans-serif,宋体, PMingLiU,serif; font-size: 10.5pt; line-height: 1.5; } html, body { } h1 { font-size:1.5em; font-weight:bold; } h2 { font-size:1.4em; font-weight:bold; } h3 { fon

Markdown 教程

Markdown 简介 Markdown 是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档. Markdown 语言在 2004 由约翰·格鲁伯(英语:John Gruber)创建. Markdown 编写的文档可以导出 HTML .Word.图像.PDF.Epub 等多种格式的文档. Markdown 编写的文档后缀为 .md, .markdown. Markdown 应用 Markdown 能被使用来撰写电子书,如:Gitbook. 当前许多网站都广泛使用 Markdown

Cordova 代码热更新 - 简书

原文:Cordova 代码热更新 - 简书 Cordova 代码热更新 [图片上传失败...(image-a19be7-1521624289049)] 基于 Cordova 框架能将网页应用 (js, html, css, 图片等) 打包成 App.当 App 在应用商店上架后,如何快速更新是我们需要考虑的问题.?? 本地打包新版本 App 发布到应用商店,但这中发布流程耗费时间,尤其是 Apple Store 应用加载网络资源,这样 App 展示的内容就可以保证是最新的,但当应用断网时,应用就

个人技术博客的选择:CSDN、博客园、简书、知乎专栏还是Github Page?(转)

个人技术博客的选择:CSDN.博客园.简书.知乎专栏还是Github Page? 有很多技术人员在学习到一定程度后发现了写博客的重要性,一方面帮助自己记忆,一方面也能帮助他人解决问题,于是会选择自己开始写博客,之后又发现平台太多不知从何下手,在这里我根据自己写博客的经验比较一下各个平台的优缺点. 这里主要对比CSDN.博客园.简书.知乎专栏.Github Page.个人建站和其他 CSDN 笔者是CSDN的长期用户,也见到了很多不错的CSDN博客 优点 SEO做得好,无论是百度还是google(

【凯子哥带你学Android】Andriod性能优化之列表卡顿——以“简书”APP为例

这几天闲得无聊,就打开手机上的开发者模式里面的"GPU过度绘制"功能,看看别家的App做的咋样,然后很偶然的打开了"简书",然后就被它的过度绘制惊呆了,于是写了这篇性能分析的文章,从一个只有APK文件的角度,说下如何寻找布局中可能存在的性能问题,以及解决方案.本文章以简书Android最新版本1.9.1进行分析. GPU过度绘制 Hierarchy View SysTrace TraceView 总结 分析资源下载 GPU过度绘制 首先打开下面两个功能开关 开发者模