您的位置:首页 > 其它

csdn下勉强使用"markdown"来撰写博客

2014-11-09 23:34 309 查看

写在前面

我也是才接触markdown,从清水河畔/github/简书等地方或多或少接触到了markdown这个东西.

大概说下markdown的几个特性:

轻量级的标签语言,简单易学,学习成本低
纯文本语言,所思即所得,应用广泛;
跨平台,不再受到word等office的约束

工具这里就不提了,不同的平台都可以搜到对应的工具. 回到题目上来,csdn作为一个IT类主题的博客,竟然不支持markdown,真是有点说不过去. 但是还是有办法的,我们自己在本地写好markdown的文件,将它转化为html文本,然后在csdn的源代码模式下,粘贴html代码即可. 用这种思路,其实也可以很方便地将csdn上的博客的html代码转化为markdown或者pdf文件.

我记笔记,用的是Wiznote也是跨平台的,发现现在可以写markdown语法,题目名字价一个.md的后缀,保存并阅览就可以查看效果. 但是另存为html,html的格式中有很多Wiz自己的格式,复制到csdn上并不支持. 于是可以去在线的网站上转换,比如 : [一个开源网站](http://tool.oschina.net/markdown), 我在linux下面使用pandoc工具进行转换,具体用法可以参见帖子:pandoc的安装与用法

下面给出cmd的markdown使用教程,参考帖子:
Cmd Markdown 简明语法手册

====================================================================================

Cmd Markdown 简明语法手册

标签: Cmd-Markdown

1. 斜体和粗体

使用 * 和 ** 表示斜体和粗体。

示例:

这是 斜体,这是 粗体

2. 分级标题

使用 === 表示一级标题,使用 --- 表示二级标题。

示例:

```

这是一个一级标题

这是一个二级标题

这是一个三级标题

```

你也可以选择在行首加井号表示不同级别的标题 (H1-H6),例如:# H1, ## H2, ### H3,#### H4。

3. 外链接

使用 [描述](链接地址) 为文字增加外链接。

示例:

这是去往 本人博客 的链接。

4. 无序列表

使用 *,+,- 表示无序列表。

示例:

无序列表项 一
无序列表项 二
无序列表项 三

5. 有序列表

使用数字和点表示有序列表。

示例:

有序列表项 一
有序列表项 二
有序列表项 三

6. 文字引用

使用 > 表示文字引用。

示例:

野火烧不尽,春风吹又生。

7. 行内代码块

使用 `代码` 表示行内代码块。

示例:

让我们聊聊
html


8. 代码块

使用 四个缩进空格 表示代码块。

示例:

[code]这是一个代码块,此行左侧有四个不可见的空格。

9. 插入图像

使用 ![描述](图片链接地址) 插入图像。

示例:



Cmd Markdown 高阶语法手册

1. 内容目录

在段落中填写
[TOC]
以显示全文内容的目录结构。

[TOC]

2. 标签分类

在编辑区任意行的列首位置输入以下代码给文稿标签:

标签: 数学 英语 Markdown

或者

Tags: 数学 英语 Markdown

3. 删除线

使用 ~~ 表示删除线。

~~这是一段错误的文本。~~

4. 注脚

使用 [^keyword] 表示注脚。

这是一个注脚[^footnote]的样例。

这是第二个注脚[^footnote2]的样例。

5. LaTeX 公式

$ 表示行内公式:

质能守恒方程可以用一个很简洁的方程式 来表达。

$$ 表示整行公式:

访问
MathJax 参考更多使用方法。

6. 加强的代码块

支持四十一种编程语言的语法高亮的显示,行号显示。

非代码示例:

$ sudo apt-get install vim-gnome


Python 示例:

```python@requires_authorizationdef somefunc(param1='', param2=0): '''A docstring''' if param1 > param2: # interesting print 'Greater' return (param2 - param1 + 1) or None

class SomeClass: pass

message = '''interpreter ... prompt''' ```

JavaScript 示例:

``` javascript/*** nth element in the fibonacci series.* @param n >= 0* @return the nth element, >= 0.*/function fib(n) { var a = 1, b = 1; var tmp; while (--n >= 0) { tmp = a; a += b; b = tmp; } return a;}

document.write(fib(10));```

7. 流程图

示例

```flowst=>start: Start:>https://www.zybuluo.comio=>inputoutput: verificationop=>operation: Your Operationcond=>condition: Yes or No?sub=>subroutine: Your Subroutinee=>end

st->io->op->condcond(yes)->econd(no)->sub->io```

更多语法参考:流程图语法参考

8. 序列图

示例 1

seqAlice->Bob: Hello Bob, how are you?Note right of Bob: Bob thinksBob-->Alice: I am good thanks!


示例 2

seqTitle: Here is a titleA->B: Normal lineB-->C: Dashed lineC->>D: Open arrowD-->>A: Dashed open arrow


更多语法参考:序列图语法参考

9. 表格支持

示例:

| 项目 | 价格 | 数量 || -------- | -----: | :----: || 计算机 | $1600 | 5 || 手机 | $12 | 12 || 管线 | $1 | 234 |

10. 定义型列表

名词 1: 定义 1(左侧有一个可见的冒号和四个不可见的空格)

代码块 2: 这是代码块的定义(左侧有一个可见的冒号和四个不可见的空格)

[code]    代码块(左侧有八个不可见的空格)

11. Html 标签

本站支持在 Markdown 语法中嵌套 Html 标签,譬如,你可以用 Html 写一个纵跨两行的表格:

[code]<table>
    <tr>
        <th rowspan="2">值班人员</th>
        <th>星期一</th>
        <th>星期二</th>
        <th>星期三</th>
    </tr>
    <tr>
        <td>李强</td>
        <td>张明</td>
        <td>王平</td>
    </tr>
</table>

值班人员星期一星期二星期三
李强张明王平

12. 内嵌图标

本站的图标系统对外开放,在文档中输入

[code]<i class="icon-weibo"></i>

即显示微博的图标:

替换 上述
i 标签
内的
icon-weibo
以显示不同的图标,例如:

[code]<i class="icon-renren"></i>

即显示人人的图标:

更多的图标和玩法可以参看
font-awesome 官方网站。

[^footnote]: 这是一个 注脚 的 文本

[^footnote2]: 这是另一个 注脚 的 文本
内容来自用户分享和网络整理,不保证内容的准确性,如有侵权内容,可联系管理员处理 点击这里给我发消息
标签: