本站使用Markdown作为文章编写语法,同时完全兼容HTML超文本标记语言。
Markdown
简介
Markdown是一种可以使用普通文本编辑器编写的标记语言,通过简单的标记语法,它可以使普通文本内容具有一定的格式。
优点
为什么推荐大家应该用 Markdown 来撰写文稿
Markdown 是一种「标记语言」,通常为程序员群体所用。大部分人用 Word 或 Pages 写作,过去的文档也大都以 .doc, .docx 格式或是 Pages 格式储存。还有人为了保证文稿发给谁都能正常打开,会用 .txt 格式。
然而.doc 或 Pages 格式有如下问题:
- 不一定谁都能打开。用 Windows 的人打不开 .pages 文件,用旧版 Word 的人不一定能打开你用新版 Word 写的稿子。
- 对方看到的稿子的样子和你自己看到的可能差别很大。
- Office 已经是你电脑上唯一的盗版软件,导致心情不佳。
.txt 格式的问题在于没有样式:
收到稿子的编辑和设计师可能不知道哪个是小标题,哪里需要斜体,哪里需要加粗。
这就是 Markdown 登场的时候了。
用 Markdown 有如下好处:
- 兼顾了「什么人都能打开」和「样式」。Markdown 就是纯文本,就是 txt,所以什么人都能打开。而如上所述,你可以用它来标记文本的样式,而且语法非常简单。
由于是纯文本,Markdown 文稿也不会因为未来软件升级而产生不同版本之间的兼容问题,即,不会出现「我这篇稿子是用旧版 Word 写的,你用新版 Word 看可能格式会有点问题」的情况。 -
Markdown 转 HTML 非常方便。HTML 是整个万维网(web)的标记语言,但更重要的是,它也是目前主流电子书格式所用的标记语言。无论是 EPUB, mobi,还是 Kindle 用的专有格式 .azw,都只是把一堆 HTML 文件打包而已。如果你写的是书,用 Markdown 标注格式之后,可以很方便地转为以上格式(当然这个转换工作不需要由你来做);如果你写的是单篇的文章(例如新闻报道或专栏),未来也不排除结集出书的可能。若采用 Markdown,对于日后的文件转换工作也大有裨益。
在此,我们总结 Markdown 的优点如下:
- 纯文本,所以兼容性极强,可以用所有文本编辑器打开。
- 让你专注于文字而不是排版。
- 格式转换方便,Markdown 的文本你可以轻松转换为 html、电子书等。
- Markdown 的标记语法有极好的可读性。
如何开始用 Markdown?继续用你习惯的写作软件即可。记事本、Word、Pages 都没问题,但请记得存成纯文本格式。就这么简单。
语法说明
语法说明详见简书的献给写作者的 Markdown 新手指南。文章深入浅出地讲述了基本语法规则。
当然,本站使用的插件WP Editor.md
也有可视化的按钮,可以让你如Word般操作地快速上手。
HTML
HTML相对于Markdown稍有难度,相关教程可以参照w3school。网站拥有上千实例以及可视化编辑器,十分安利。
其他
支持 Bilibili 表情
后端请按提示切换后台为明亮主题(个人资料页切换),否则评论管理页将出现表情鬼畜。
文章目录
使用了开源项目[tocbot]
,在需要目录的文章任意位置输入 [toc] 即可启用(在文章右边有目录导航栏,自动定位H1-H4字体)。文章首字的大写使用方法:把首字放到 [begin] 和[/begin] 之间。
添加图片

<div align=center>
<img src="http://www.imoe.club/wp-content/uploads/2018/09/49127594_p0.jpg" width="213" hegiht="300" />
</div>
其中align
是分布位置,可以left,center,right;width
与height
是宽与长的像素;src
是图片源。
Markdown中语法更加简便,但是对居中较难控制。
添加可放大预览的图片

点击该图片可以放大至全屏,再次点击空白部分即可还原,有利于提升网页加载速度(类似查看原图功能)。代码如下:
<center>
[](http://www.imoe.club/wp-content/uploads/2018/09/36490785_p0.jpg)
</center>
基本格式为[](URL)
。其中text
显示放大后底部说明文字,url
为小图图片源,URL
为放大图图片源。<center></center>
可用于各元素的居中。
添加视频
本地源
视频来自bilibili拜年祭单品
这是一个居中的视频,代码如下:
<p align="center">
<video width="640" height="360" display: block controls="controls"
poster="http://www.imoe.club/wp-content/uploads/2018/09/67852772_p0-e1538131774851.png">
<source src="http://www.imoe.club/wp-content/uploads/2018/09/exchange.mp4" />
</video>
</p>
其中align
是分布位置,可以left,center,right;width
与height
是宽与长的像素;poster
是视频初始封面显示;source
是视频源。
网络视频(B站除外)
https://www.iqiyi.com/v_19rr25laco.html
这是一个自适应居中的在线视频,代码如下:
https://www.iqiyi.com/v_19rr25laco.html
只需将地址单独一行放置,上下行留空即可。
注意:请勿将B站视频地址采取此方法,否则在电脑端会无法播放。(仅在Safari上可以播放)
Bilibili视频
使用bilibili自带的H5弹幕播放器设置方法:
- 打开网页版bilibili,找到要嵌入的视频。
- 按下图方式复制代码。
- 粘贴代码至文章内,适当修改参数。
以本B站视频为例,代码如下:
<iframe src="//player.bilibili.com/player.html?aid=20825469&cid=34114664&page=1" width="780" height="480" scrolling="no" border="0" frameborder="no" framespacing="0" allowfullscreen="true"> </iframe>
其中src
中的aid
即为视频av号,cid
是视频外接口api的特征码。width
与height
即为播放器的宽与高。其余参数默认即可。一般来说,我们复制完嵌入代码后只需在src
后根据原视频比例加入width
与height
即可。
鸣谢
感谢开源主题Sakura&作者Mashiro的教程指导~
Comments | NOTHING