Markdown语法 与 Hexo常用指令

Markdown语法 与 Hexo常用指令

Markdown

Hexo

Markdown是一种超轻量级的标记语言,常用的标记符号不超过十个,相对于更为复杂的HTML标记语言来讲,Markdown实在简便多了,因此学习成本也不是很大。更多关于Markdown的认识,我们可以参考:认识与入门 Markdown

Markdown工具

关于支持Markdown的书写工具网络上有很多推荐,这里不再一一列举,常用的有:

Mou:外文世界对 MarkDown 的热衷在 Mac 上可见一斑,目前虽是免费的,但功能性却能比肩同类的收费软件。

Sublime Text 3:支持 OS X、Windows、Ubuntu 等 UNIX 及 Linux 操作系统,在代码工作者圈内相当出名。

MarkdownPad2:推荐较多,但是免费版的有些扩展功能受限。

小书匠:有**网页版客户端**: 支持实时同步预览,编辑器同步滚动,多种系统内置的主题等特点。

简书:是一家由国内初创团队建立的在线文字创作及发布平台。

Cmd Markdown:Windows/Mac/Linux 全平台客户端。

常用语法

常见格式及其对应的语法:

Markdown

注释与示例:

粗体

在字体两侧分别加两个星号 ** , 当然,也能使用快捷键 Ctrl + B 快速加粗;

斜体

将需要设置为斜体的文字两端使用一个 * (或者 _ ) 夹起来,快捷键 Ctrl + I ;

删除线

在需要设置删除线的文字两侧加两个波浪线 ~~ 夹起来,可以表示删除文字;

分割线

分割线的语法只需要三个星号*或者三个小短线 - 号,例如:



外链接

[描述](链接地址) 为文字添加外链接,可以使用快捷键 Ctrl + L 快速设置;

示例: [HarbingWang的博客](http://harbingwang.github.io)

显示: 这里是HarbingWang的博客 链接。

内嵌代码

第一种:引入单行代码出现一个代码框,需要使用键盘左上角的ESC键下面的反单引号夹在文字两侧,两侧各一个就行。

例如:\`Hellow world!`

显示:

Hellow world!

第二种:多行代码的引入需要在代码段的前后分别使用三个反单引号

显示:

for (int i = 0; i < 100; i++)
{
      printf("hello markdown!\n");
}

引入内容

第一种:通过在文字开头添加“>”表示块注释,快捷键使用 Ctrl + Q 例如;

如果你无法简洁的表达你的想法,那只说明你还不够了解它。 -- 阿尔伯特·爱因斯坦

第二种: 使用tab键或者四个空格

一个项目两部电脑三餐盒饭只为四千工资搞得五脏俱损六神无主仍然七点起床八点开会处理九个漏洞十分辛苦
十年编码九年加班八面无光忙的七窍生烟到头六亲不认五体投地依旧四肢酸软三更加班只为二个臭钱一生孤苦

插入图片

插入图片的语法与插入链接很像,区别在一个插入图片的时候需要加一个!

Markdown语法: ![描述](图片链接地址)

示例:

Github

  • 插入图片的地址需要图床生成图片外链,这里推荐使用七牛图床,生成URL地址即可。

  • 不同Markdown工具下插入图片的方式也有所不同,这里只说明通用做法,具体可参考编辑器的使用说明;

分级标题

标题是每篇文章中最常用的格式,在Markdown语法中,如果某行文字被定义为标题,只需要在行首加上#符号即可:

H1 : # Header 1
H2 : ## Header 2
H3 : ### Header 3
H4 : #### Header 4
H5 : ##### Header 5
H6 : ###### Header 6
  • 是几级标题就用几个 # 符号,每增加一个 # 表示更深入一个层次的内容,总共有六级标题。
  • 标准的Markdown语法需要在符号后面多加一个空格,建议加上。

上面这种设置标题的方式是最为直观的,当然在Markdown语法下,我们也可以通过在文字下方添加“=”和“-”,他们分别表示一级标题和二级标题,例如:

我是一级标题
====

我是二级标题
----

无序列表

使用一个 *+- 表示无序列表。

示例:

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

有序列表

使用数字和英文句点表示有序列表, 不要求数字一定要连续。

示例:

  1. 有序列表项 一
  2. 有序列表项 二
  3. 有序列表项 三

绘制表格

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

反斜杠

Markdown 支持在以下这些符号前面加上反斜杠来帮助插入普通的符号:

\   反斜线
`   反引号
*   星号
_   底线
{}  花括号
[]  方括号
()  括弧
#   井字号
+   加号
-   减号
.   英文句点
!   惊叹号

以上的Markdown语法基本上足够我们书写一篇博客了,关于Markdown的高级用法,包括通过Markdown创建公式,绘制流程图等请参考本文底部的 Reference相关;


Hexo常用指令

以下关于Hexo常用指令的整理,要想熟练使用一个工具,首先就要熟练掌握他的相关指令,以便操控这一工具。下面将着重介绍几条常用的 Hexo 指令:

1、新建文章

hexo new articleName

 Note:

  • 新建一篇题为“articleName”的文章,此时会在E/Hexo/source/_posts/目录下生成一份articleName.md 的文件,使用Notepad++、小书匠、MarkdownPad2等编辑工具打开即能书写;
  • 提示信息:INFO Created: E:\Hexo\source_posts\articleName.md
  • 如果标题包含空格,需要使用双引号括起来

2、新建页面

hexo new page pageName

 Note:

  • 新建一个题为“pageName”的页面,此时会在E:\Hexo\source\目录下生成一个名为pageName的文件夹,其中包含一份 index 的md文件;
  • 提示信息:INFO Created: E:\Hexo\source\pageName\index.md
  • 同样地,如果语句中包含空格,需要使用双引号括起来

3、生成静态页面

hexo generate

Note:

  • 启动该条指令后会将当前网页的内容生成静态页面到public目录下
  • 提示信息:

    INFO Start processing

    INFO Files loaded in 595 ms

    INFO 0 files generated in 612 ms

4、开启本地服务器端口

hexo server

Note:

  • 开启预览访问的端口,默认端口为4000
  • 关闭server使用 ctrl + c
  • 提示信息:

    INFO Start processing

    INFO Hexo is running at http://0.0.0.0:4000/. Press Ctrl+C to stop.

  • 在使用hexo server 可能会遇到端口被占用的情况,不妨使用以下指令来更改端口
hexo server -p 4001

5、部署到Github

hexo deploy

Note:

  • 将 E/Hexo/目录下的 .deploy_git 文件夹部署到Github
  • 部署前需要预先 hexo generate 生成静态文件
  • 关闭server使用 ctrl + c
  • 提示信息:

    INFO Deploying: git

    INFO Clearing .deploy_git folder...

    INFO Copying files from public folder...

    .....部署的文件

    To [email protected]:HarbingWang/harbingwang.github.io.git

    da818a3..e4e53c6 HEAD -> master

    INFO Deploy done: git # 当看到 “INFO Deploy done: git”时即表示部署已经完成;

6、清除文件

hexo clean

Note:

  • 清除E/Hexo目录下的缓存文件(db.json)和已经生成的静态文件(public)文件
  • 网页正常情况下可以忽略此条命令

7、查看Hexo版本

hexo version

Note:

  • 查看当前使用的Hexo的版本号
  • 提示信息:

    hexo: 3.2.0

    hexo-cli: 1.0.1

    os: Windows_NT 6.1.7601 win32 x64

    http_parser: 2.6.2

    node: 5.10.0

    v8: 4.6.85.31

    uv: 1.8.0

    zlib: 1.2.8

    ares: 1.10.1-DEV

    icu: 56.1

    modules: 47

    openssl: 1.0.2g

复合指令

hexo g -d
hexo s -d

Note:

  • hexo g -d # 等价于 hexo generate --deploy :生成静态文件并部署
  • hexo s -d # 等价于 hexo deploy --generate :开启预览并部署到Github

简写形式

hexo n #等价于 hexo new
hexo g #等价于 hexo generate
hexo s #等价于 hexo server
hexo d #等价于 hexo deploy
hexo v #等价于 hexo version

如何卸载Hexo?

3.0.0版本执行npm uninstall hexo-cli -g,之前版本执行npm uninstall hexo -g

## 如何安装旧版本Hexo?

 先卸载当前版本,以2.8.3为例,执行npm install [email protected] -g,再初始化并安装依赖和插件。

Reference

整理过程中难免有所疏漏,失误之处还请指正,更多详细内容请参考:

时间: 2024-07-30 13:48:59

Markdown语法 与 Hexo常用指令的相关文章

Angular 2 模板语法与常用指令简介

一.模板语法简介 插值表达式 <div>Hello {{name}}</div> 等价于 <div [textContent]="interpolate(['Hello'], [name])"></div> 模板表达式 1.属性绑定 1.1输入属性的值为常量 <show-title title="Some Title"></show-title> 等价于 <show-title [titl

Markdown 语法说明

NOTE: This is Simplelified Chinese Edition Document of Markdown Syntax. If you are seeking for English Edition Document. Please refer to Markdown: Syntax. 声明: 这份文档派生(fork)于繁体中文版,在此基础上进行了繁体转简体工作,并进行了适当的润色.此文档用 Markdown 语法编写,你可以到这里查看它的源文件.「繁体中文版的原始文件可以

简体中国版文档的Markdown语法

Markdown文件 注意︰这是简体中国版文档的Markdown语法.如果你正在寻找英语版文档.请参阅Markdown︰ Markdown: Syntax. Markdown: Syntax 概述 哲学 行内 HTML 特殊字符自动转换 区块元素 段落和换行 标题 区块引言 清单 程序代码区块 分隔线 区段元素 连结 强调 程序代码 图片 其他 跳脱字符 自动连结 感谢 注意:这份文件是用Markdown写的,你可以看看它的原始档 . 概述 哲学 Markdown的目标是实现「易读易写」. 不过

linux下svn常用指令

windows下的TortoiseSVN是资源管理器的一个插件,以覆盖图标表示文件状态,几乎所以命令都有图形界面支持,比较好用,这里就不多说.主要说说linux下svn的使用,因为linux下大部分的操作都是通过命令行来进行,所以必须得掌握linux下svn的常用指令.当然linux下也有模仿TortoiseSVN的linux X程序,例如RabbitVCS,模仿程度很高,但很容易拖慢X,因此不推荐. (如果是第一次提交文件,很可能会出现"svn:'.'不是工作副本",即当前目录不是工

Markdown语法的简要规则

Markdown 语法的简要规则 标题 标题是每篇文章都需要也是最常用的格式,在 Markdown 中,如果一段文字被定义为标题,只要在这段文字前加?#?号即可. # 一级标题 ## 二级标题 ### 三级标题 以此类推,总共六级标题,建议在井号后加一个空格,这是最标准的 Markdown 语法. 列表 熟悉 HTML 的同学肯定知道有序列表与无序列表的区别,在 Markdown 下,列表的显示只需要在文字前加上?-?或?*?即可变为无需列表,有序列表则直接在文字前加?1.?2.?3.符号要和文

Markdown语法与入门

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

走进AngularJs(二) ng模板中常用指令的使用方式

通过使用模板,我们可以把model和controller中的数据组装起来呈现给浏览器,还可以通过数据绑定,实时更新视图,让我们的页面变成动态的.ng的模板真是让我爱不释手.学习ng道路还很漫长,从模板开始入手是个不错方式,因为这部分内容相对简单好理解,而且是视图层的东西,大家都喜欢可以立马看得见的东西嘛.本篇我将搜罗模板中的常用指令一一测试,了解其使用方法,有点像背单词的感觉,会比较枯燥.不过对于初学,这样的枯燥是必须要经历的,开始~ 一.模板中可使用的东西及表达式 模板中可以使用的东西包括以下

Markdown 语法说明 (简体中文版)

<< [访问 Wow!Ubuntu](http://wowubuntu.com) **NOTE:** This is Simplelified Chinese Edition Document of Markdown Syntax. If you are seeking for English Edition Document. Please refer to [Markdown: Syntax][eng-doc]. [eng-doc]:http://daringfireball.net/pr

DOS批处理之常用指令(一)

常用指令:echo指令.@指令.call指令.pause指令.rem指令 echo指令: 语法:echo [on|off] [Message] 功能: 显示消息.打开或关闭所有指令的回显功能.显示现在的回显设置. ①使用没有任何参数的echo用来查看当前回显设置 echo  ②加参数(Message)用来显示消息 echo Hello,DOS     ③加参数来打开(on)或关闭(off)回显 echo off       echo echo完整示例:        echo        ec