Markdown编辑器使用的一些技巧
吐槽一下CSDN markdown编辑器:
(1) markdown编辑器的预览界面与显示效果的界面不完全一致。预览效果比发出来的效果要好一些。
(2) 用#开头的标题,不会自动加粗。但自动加粗是有必要的,使标题更醒目。尤其是博客的主题(博客皮肤),对于那些不加粗的标题完全与正文混在了一起,太不容易辨识了。所以,每次都是手动将所有标题都加粗(Ctrl+B或手输
** **
)(3) 用*开头的列表,在
m.blog.csdn.net
会把列表项前面的那个黑点丢了,以至于在手机上看的话,不知道段落关系。所以有些地方不得不写成这样* (1) xxx
,感觉怪怪的。
同样,有序列表(用1. 2.开头的)也存在这个问题。(4) 表格之后,即使空了一行或多行,所写的内容还是会紧贴着表格的下端。这个问题是其他markdown编辑器没有的。解决方法:可以在表格之后的下一行加上<br>
注:本文中的 段落代码 对应的英文为 fenced code 。行内代码对应的英文为inline code。都是本人按照意译来翻译的,如果翻译错了,请原谅。
段落代码,效果如下:
void function() {
// print Hello World
}
行内代码,效果如下:(function()和Hello World是行内代码)
例句:function()
被调用后,将输出Hello World
。
当然,段落代码和行内代码中可以写任意文字,不必是代码。
注:本文的内容适用于大多数markdown编辑器。
1. 尖括号的处理:<>
例如,在正文中写上ArrayList<String>
,你会发现效果为ArrayList。那个尖括号中的内容都丢了,而且不易发现。原因可能是<String>
被认为是HTML的标签了。
解决方法1:
在正文中使用尖括号时,使用<
来代替<
,用>
代替>
。
例如ArrayList<String>
会显示为ArrayList<String>。
解决方法2:
如果尖括号出现在代码中,即用 ` 行内代码 `或者用 ` ` ` 段落代码 ` ` ` 括起来的,则直接写上尖括号即可。
2. 输入特殊字符,例如 <和>
解决方法:
用&
来代替&
。即,&lt;
显示为 < 。&gt;
显示为 > 。
在正文中如何输入&
呢?即不放在行内代码中。同样,用&
来代替&
。
写出来是&#38;
,显示效果为 &。
有没有一种递归的感觉?!
3. 输入反引号` `
例如,这句话:如果使用行内代码的效果,则把代码写到两个反引号中,例如`your code`。
如果在正文中直接输入两个反引号,显示的效果是your code
,而不会出现上面的反引号。
解决方法:
在正文中,用反斜杠来转义。即输入 \`,显示效果就是一个反引号 ` 了。
问题来了,\`是怎么输出来的?写法是这样:\\`。
\\` 是怎么输出来的?写法是这样:\\\\`。
以此类推。
注:对于有些markdown编辑器,对这种转义支持的不好,需要用** **
加粗把\\`这种形式包裹起来,才能显示为准确形式。否则,一行里出现两个反引号,可能会把反斜杠当成行内代码了。
4. 语法高亮
可以参考:Haroopad Markdown 编辑器代码语法高亮支持,CSDN markdown编辑器和Haroopad基本上是一样的。
5. 如何在表格中输入竖线
6. CSDN markdown编辑器的快捷键
功能 | 快捷键 |
---|---|
行内代码 或 段落代码 | Ctrl + K 在空白行,执行Ctrl+K会生成段落代码(3个反引号); 在一行的文字中,执行Ctrl+K 生成行内代码。 |
加粗 | Ctrl + B |
斜体 | Ctrl + I |
添加引用 | Ctrl + Q |
添加图片 | Ctrl + G |
注:段落代码 是我自己的译法,对应的英文为fenced code。
7. 引用风格的链接(Reference-style links)
链接可以有2种写法:
(1) 一般形式:
[写上描述](写上链接地址)
,例如[Haroopad Markdown 编辑器代码语法高亮支持](http://blog.csdn.net/u013553529/article/details/50629055)
(2) 引用的形式:分为2个部分。
- 链接的使用:
[写上描述][引用的字符串]
,对用户是可见的 - 链接的声明:
[引用的字符串]: 链接地址 "链接的描述"
,用户是看不见的
- 链接的使用:
使用引用风格的链接的好处,是可以让编辑正文时更简洁,尤其是一个链接多次出现在正文中的时候。
注:在Haroopad编辑器中,『引用的字符串』必须是全小写,否则不起作用。
通常把链接的声明放到正文的最下方,并用3个或3个以上的横线将正文与引用链接隔离开。如下面的例子。
例如,引用风格的链接写法如下:
[Haroopad Markdown 编辑器代码语法高亮支持][1]
[打造自己的Android源码学习环境之一:序][android_study_env]
---
[1]: http://blog.csdn.net/u013553529/article/details/50629055 "markdown代码语法高亮"
[android_study_env]: http://blog.csdn.net/u013553529/article/details/54829345 "android study environment"
注1:起一个容易辨识的名字(如android_study_env
)比单个字符(如1
)更不容易写错。用数字或者字母来编序号,可以方便书写。
注2:对图片链接同样适用。即,可以使用![]()
或者![][]
。
把上面的段落代码中的内容放到正文中,效果如下:
Haroopad Markdown 编辑器代码语法高亮支持
打造自己的Android源码学习环境之一:序
8. 表格的写法
完整的表格写法,如下:
| 列名1 | 列名2 |
| --- | --- |
| 内容1 | 内容2 |
显示效果:
列名1 | 列名2 |
---|---|
内容1 | 内容2 |
简易的写法:
列名1 | 列名2
--- | ---
内容1 | 内容2
显示效果:(跟完整写法一样)
列名1 | 列名2 |
---|---|
内容1 | 内容2 |
表格中内容的对齐:
通过在横线那一行加上冒号,冒号的位置 表示不同的对齐方式。
左对齐::---
居中对齐::---:
右对齐:---:
默认的对齐方式是左对齐。
默认左对齐 | 左对齐 | 居中对齐 | 右对齐
--- | :--- | :---: | ---:
本列左对齐 | 本列左对齐 | 本列居中 | 本列右对齐
本列左对齐 | 本列左对齐 | 本列居中 | 本列右对齐
本列左对齐 | 本列左对齐 | 本列居中 | 本列右对齐
本列左对齐 | 本列左对齐 | 本列居中 | 本列右对齐
显示效果:
默认左对齐 | 左对齐 | 居中对齐 | 右对齐 |
---|---|---|---|
本列左对齐 | 本列左对齐 | 本列居中 | 本列右对齐 |
本列左对齐 | 本列左对齐 | 本列居中 | 本列右对齐 |
本列左对齐 | 本列左对齐 | 本列居中 | 本列右对齐 |
本列左对齐 | 本列左对齐 | 本列居中 | 本列右对齐 |