test markdown
Markdown和Haroopad介绍文档
[TOC "float:right"]
什么是Markdown
Markdown 是一种轻量级标记语言,创始人为约翰·格鲁伯(John Gruber)。简而言之的说,它可以通过类似HTML的标记语法,使普通文本内容具有一定的格式。
Markdown有哪些优点
- 纯文本实现,使用任何文本编辑器均可编辑,全平台通用。
- 排版清晰简洁,可读性较高,使用扩展可以获得更多语法格式支持,漂亮美观。
- 语法简洁,上手较快,任何人均可在短时间内学会。即使不会语法的读者,也可以读懂其原始文件的内容。
- 丰富的工具链支持:
- 编辑器:各种支持所见即所得的编辑器,如本文介绍的Haroopad。
- 平台支持:各大博客系统、Wiki系统均有相关插件,代码托管平台Github也支持使用Markdown来编写Readme文件。
- 和其他格式进行转化:可以方便的转化为HTML文件等。
Markdown的基本语法
Markdown的基本语法非常简单,本文即用Markdown完成。
标题
可以在标题内容前输入特定数量的井号('#')来实现对应级别的HTML样式的标题(HTML提供六级标题)。例如:
# 一级标题
#### 四级标题
一级和二级标题还有一种写法:
一级标题
===================
二级标题
--------------------
特殊格式字体
在需要改变的文字片段前后 使用一对符号可以改变文字为特殊格式:
- 粗体 使用
**文字**
或者__文字__
效果:这里请大家尤其注意! - 斜体 使用
*文字*
或者_文字_
效果:会不调用父类的 析构函数 呢? - 高亮 使用
==文字==
效果:这里是高亮的重点,但这里不是。 - 下划线 使用
++文字++
效果:如果此时的++判断结果为真++…… - 删除线 使用
~~文字~~
效果:1.2的版本已经修复这个Bug? - 上角标 使用
^文字^
效果:单位圆的方程式是x2+y2=1。 - 下角标 使用
~文字~
效果:最常见的氧化反应是C+O2=CO2
外部内容嵌入
- 图像 使用

来贴入图片 效果:
- 链接 使用
[linkText](url)
来插入链接 效果:
博客首页 - 电子邮件 使用
<邮件地址>
来插入邮件地址 效果:cdsama@gmail.com
列表
无序列表
使用如下格式(*+-可以任意替换):
* 第一章
* 第二章
+ 第一条
+ 第二条
- 第一则
效果:
- 第一章
- 第二章
- 第一条
- 第二条
- 第一则
有序列表
使用如下格式(即为效果):
- 内容
- 内容
- 内容
表格
简单表格如下,分号的位置表示对齐方式:
|这里是列名一|列二|三|
|:-|:-:|-:|
|这列是左对齐|这列是居中对齐|这列是右对齐|
|左对齐|居中对齐|右对齐|
效果:
这里是列名一 | 列二 | 三 |
---|---|---|
这列是左对齐 | 这列是居中对齐 | 这列是右对齐 |
左对齐 | 居中对齐 | 右对齐 |
1 | 2 | 3 |
分割线
以下三个连续符号构成一个分割线,分别是三种不同的分割线:
***
---
___
效果:
换行、空格和标记符号
在浏览器中一般情况下,Markdown会删除所有换行和空格,打乱原有的缩进和排版。通过回车和至少两个空格可以强制换行。
要打出连续空格可以用输入法输入全角中文空格或者:
半字大的空白
或
全字大的空白
或
不断行的空白格
或
若要输出符号原本的意思可以加斜线\来输出 例如:
* 不是列表
引用
使用右尖括号即可插入一段引用,例如:
> 这里是一段引用
>> 书是人类进步的阶梯。 --高尔基
>
> 退出二级引用
效果:
这里是一段引用
书是人类进步的阶梯。 --高尔基
退出二级引用
代码
使用一对反引号即可包含一个行内代码使用一对三个反引号可以包括多行代码,另外多行Tab也可以用于代码段,例如:
code
code blocks
效果:print("hello");
#include <iostream>
int main()
{
std::cout<<"hello world!""<<std::endl;
return 0;
}
Haroopad介绍
Haroopad是一个韩国人写的Markdown编辑器,项目主页是:
Haroopad - The Next Document processor based on Markdown
Haroopad的优点和缺点
优点:
- 跨Windows、Mac、Linux三大平台。
- 支持实时渲染,可以在编写的时候实时查看效果。
- 支持复制、导出到HTML。
- 支持多种编程语言语法高亮。
- 支持绘制各种流程时序图等非标准Markdown格式。
缺点:
- 暂时不支持导出到PDF等格式
Haroopad支持的额外语法
目录
单行插入
脚注
使用[^id]
[^id]:text
即可生成一对脚注 [1]
代码语法高亮
在```后加入编程语言名称
例如````python`
@requires_authorization
def somefunc(param1='', param2=0):
'''A docstring'''
if param1 > param2: # interesting
print 'Greater'
return (param2 - param1 + 1) or None
class SomeClass:
pass
>>> message = '''interpreter
... prompt'''
计划任务列表
使用- [ ] task name
- [x] finished task
来创建计划任务。
效果:
- [x] 任务1
- [x] 任务2
图像绘制
图像绘制使用了mermaid引擎(访问该项目地址)。
目前支持流程图和时序图,可以在该项目Wiki上查看更多用法,以下列举两个最基本的例子。
流程图:
subgraph 子图
a1[矩形]
a2>旗帜形]
a3(圆角方形)
end
subgraph 第二个子图
b1((圆形))
b2{斜方形}
end
a1-->|实线箭头|a2
a2-->a1
a2-.->|虚线箭头|a3
a3-.->a2
a3==>|加粗箭头|a1
a1==>a3
b1---b2
b2---|实线无箭头|b1
a1-->b1
时序图:
Alice->>Bob: Hello Bob, how are you?
alt is sick
Bob->>Alice: Not so good :(
else is well
Bob->>Alice: Feeling fresh like a daisy
end
opt Extra response
Bob->>Alice: Thanks for asking
end
tests
这里是一个示例脚注。 ↩︎
test markdown的更多相关文章
- NiceMark——我的Markdown编辑器
NiceMark--我的Markdown编辑器 闲来无事,写了一个Markdown编辑器.基于electron,完全采用Web前段技术(Html,css,JavaScript)实现.代码已托管在Git ...
- Markdown 图片助手-MarkdownPicPicker
title: Markdown 图片助手 v0.1 toc: true comments: true date: 2016-06-04 16:40:06 tags: [Python, Markdown ...
- 前端学Markdown
前面的话 我个人理解,Markdown就是一个富文本编辑器语言,类似于sass对于css的功能,Markdown也可以叫做HTML预处理器,只不过它是一门轻量级的标记语言,可以更简单的实现HTML ...
- 好用的Markdown编辑器一览 readme.md 编辑查看
https://github.com/pandao/editor.md https://pandao.github.io/editor.md/examples/index.html Editor.md ...
- mac好用的markdown编辑器
在刚开始接触markdown的时候,就被吸引了.此后一直在找贴心的好用的markdown编辑器.印象笔记和马克飞象配合着用也是挺好的,唯一的缺点就是比较封闭,发个笔记的链接给同学,还得注册才能看,导致 ...
- Markdown学习笔记
分为两步: 1.阅读Markdown中文官网的文档 2.下载MarkdownPad2将中文官网中文档的例子敲一遍,其中Markdownpad2为官网中推荐的编辑器 备注: 如果只看中文官网文档,不边看 ...
- Linux 中优秀的文本化编辑思想大碰撞(Markdown、LaTeX、MathJax)
这样一个标题可能不太准确,因为确实无法准确地解释什么叫"文本化编辑思想".其实我这篇随笔主要是想探讨 Markdown.LaTeX.MathJax,有兴趣的朋友可以继续往下看,同时 ...
- Markdown是怎样接管我的各种的写作工作的
对于一个程序猿来说,没有什么比单纯的写代码更能让人兴奋了.如果能让你像写代码一样写文档,不用再面对那些繁琐的样式,你会怎么看?它就是Markdown!即使博客园已经有不少介绍的文章了,但是我依然还是不 ...
- markdown常用语法总结
转自markdown示例[模板] 1.1.段落标题 根据原文中的文档标题可以对应设置标题. # 一级标题## 二级标题### 三级标题 效果 => 一级标题 二级标题 三级标题 1.2.斜体.加 ...
- 基于 Cmd MarkDown 的 markdown 语法学习
首先我要打一个属于干货的广告:CmdMarkDown 是非常好用的markdown编辑器软件,支持全平台,由作业部落出品,分为客户端与WEB端两种使用场景. 本篇博客学习的markdown语法都是基于 ...
随机推荐
- js动画
<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8&quo ...
- [BZOJ3751][NOIP2014] 解方程
Description 已知多项式方程:a0+a1*x+a2*x^2+...+an*x^n=0 求这个方程在[1,m]内的整数解(n和m均为正整数). Input 第一行包含2个整数n.m,每两个 ...
- vmware下的centos上网配置
设置网络 1.查看网络配制 刚刚安装好的虚拟机,里面还是原始的网络配制.只有一个回环网卡. 通过ifconifg命令可以查看到. 2.添加网卡 从上面看到只有回环网卡,现在需要添加一块网卡来进行后 ...
- C++:一般情况下,设计函数的形参只需要两种形式
C++:一般情况下,设计函数的形参只需要两种形式.一,是引用形参,例如 void function (int &p_para):二,是常量引用形参,例如 void function(const ...
- android studio安卓项目出现Error: Default Activity Not Found错误无法编译的解决方案
项目明明是没有问题的,有时候突然就出现Error: Default Activity Not Found错误,以前出现过我重新安装了android studio 都没有用,后来在网上(http://s ...
- Python 爬虫4——使用正则表达式筛选内容
之前说过,使用urllib和urllib2,只是为了获取指定URL的html内容,而对内容进行解析和筛选,则需要借助python中的正则表达式来完成. 一.预备知识: 1.正则表达式简述: 什么是正则 ...
- Spark优化之二:集群上运行jar程序,状态一直Accepted且不停止不报错
如果运行Spark集群时状态一直为Accepted且不停止不报错,比如像下面这样的情况: 15/06/14 11:33:33 INFO yarn.Client: Application report ...
- Python之路第一课Day9--随堂笔记之一(堡垒机实例以及数据库操作)未完待续....
一.堡垒机前戏 开发堡垒机之前,先来学习Python的paramiko模块,该模块机遇SSH用于连接远程服务器并执行相关操作 SSHClient 用于连接远程服务器并执行基本命令 基于用户名密码连接: ...
- Java_正则表达式
1.简介 正则表达式是一串特定字符串,组成一个“规则字符串”,这个“规则字符串”是描述文本规则的工具.正则表达式就是记录文本规则的代码. 2.字符集合 [abc] a,b,c中任意一个字符 [^abc ...
- 我的emacs配置
我的emacs配置文件 ;; .emacs ;; ============================== Basic Configure START ====================== ...