Y 分钟速成 asciidoc
AsciiDoc 是一种类似于 Markdown 的标记语言,它可以用来写从书到博客的任何东西。它由 Stuart Rackham 在 2002 年发明,它的语言很简单,但同时也可以有丰富的定制。
文档标题
标题是可选的,且不可以包含空行。它必须离正文空出至少一个空行。
仅标题= 文档标题
文档的第一句话。
标题和作者
= 文档标题
张三 <san.zhang@learnxinyminutes.com>
文档开始。
多名作者的情形
= 文档标题
李四 <si@go.com>; 王五 <wu@yo.com>; 赵六 <xzhao@pirate.com>
有多名作者的文档开始。
版本行(需要作者行)
= 文档标题(第一版)
土豆人 <chip@crunchy.com>
v1.0, 2016-01-13
这篇关于炸薯条的文章会很有趣。
段落
段落不需要什么特别操作。
在两段之间用一个空行隔开。
当你需要换行时,添加一个 +
你就会得到一个换行符!
文本格式化
_用下划线创建斜体_
*用星号加粗*
*_组合起来用更有趣_*
`用重音符显示等宽字体`
`*加粗等宽字体*`
节标题= 第 0 级 (一般只用于文档标题)
== 第 1 级 <h2>
=== 第 2 级 <h3>
==== 第 3 级 <h4>
===== 第 4 级 <h5>
列表
用星号创建无序列表。
* 甲
* 乙
* 丙
用句点创建有序列表。
. 项目 1
. 项目 2
. 项目 3
你可以用额外的星号或句点来嵌套最多五次列表。
* * 甲 1
** 甲 2
*** 甲 3
**** 甲 4
***** 甲 5
. 甲 1
.. 甲 2
... 甲 3
.... 甲 4
..... 甲 5
补充材料处理
AsciiDoc 文档有两种工具:
- AsciiDoc: 原版的 Python 实现,在主流 Linux 发行版中已附带,目前处于稳定版本维护模式。
- Asciidoctor: 使用 Ruby 的另一种实现,也可以从 Java 和 JavaScript 中使用。它处于积极的开发中,目标是用新特性和输出格式扩展 AsciiDoc 的语法。
以下是 Asciidoctor 实现的相关链接:
- Markdown - AsciiDoc 语法比较:并列比较一般 Markdown 和 AsciiDoc 的元素。
- 入门:安装和快速启动指南,帮助构建简单的文档。
* Asciidoctor 用户手册: 完整的单文档指南,包含语法参考、示例、渲染工具等。
有建议?或者发现什么错误?在Github上开一个issue,或者发起pull request!
原著Ryan Mavilia,并由0个好心人修改。
Translated by: Liu Yihua
© 2022 Ryan Mavilia, Abel Salgado Romero
本作品采用 CC BY-SA 3.0 协议进行许可。
Learn X in Y minutes
Take a whirlwind tour of your next favorite language.
3 声望
2 粉丝
推荐阅读
Y 分钟速成 Git
源代码下载: gitGit 是一个分布式版本控制及源代码管理工具。Git 可以为你的项目保存若干快照,以此来对整个项目进行版本管理。版本什么是版本控制版本控制系统就是根据时间来记录一个或多个文件的更改情况的系...
小X学技术阅读 1.2k
我开发了这样一个工具,终于可以把工作“甩”给别人了!!
事情是这样的: 公司一直很想重构官网,所以有一大堆信息,例如案例信息、SEO信息、产品信息、人物信息等。本来是想做个后台管理来管理这些信息,方便后期运营的同事自己去增删改查。结果不出所料,又出现了职场...
limingcan赞 1阅读 251
2023年2月可用的免费图床
CDN加速图床cdnjson.com 成立于2020年,提供高速稳定的图片上传和分享服务。[链接]需注册无需注册HTTPS支持格式JPG PNG BMP GIF WEBP数量限制单个文件最大支持5MB(注册后可到10M),无限空间, 无限流量支持API调...
donggongai赞 1阅读 386评论 1
【算法训练营】数值计算篇
0 和 1 既不是质数也不是合数,最小的质数是 2 {代码...} 3. 计算两个数字之间的连续值(输入1,4 =>输出1,2,3,4)
代码诗人_赞 1阅读 296
一键JavaScript对象转为typescript类型(vscode插件)
基于一键Swagger类型转为typescript类型的版本升级,执行Javascript对象转为typescript类型声明。此次升级借助了@babel/types和@babel/genrator的功能,不得不说babel的能力非常的强大
CornerAK阅读 563
开源C库实现HTTP服务器:多线程+事件模型+外挂式跟踪统计
关于Melon库,这是一个开源的C语言库,这个库不依赖其他开源第三方库,因此安装方便,开箱即用。并且中英文文档详细,便于作为工具书进行查阅。Github仓库:传送门。
用户bPbzEjV阅读 544
Java代码工具快速生成词云图(强烈建议收藏)
“词云”一词最早是由美国西北大学新闻学副教授、新媒体专业主任里奇戈登(Rich Gordon)提出的。词云(Word Cloud),又称文字云、标签云(Tag Cloud)、关键词云(Keyword Cloud),是对文本信息中一定数量的关键...
我要飞的更高阅读 522
**粗体** _斜体_ [链接](http://example.com) `代码` - 列表 > 引用
。你还可以使用@
来通知其他用户。