使用 Ulysses 小半年来，PDF 输出的图片没有描述一直困扰着我，我也一直拖着不肯解决，原因是 HTML 是有图片描述的，就赖着，一直到 Reagan 同学提出了这个问题，我又重新思考解决方法，于是有了本文。

1.导出 PDF 的图片没有描述

在用 Ulysses 插入图片时会出现下面的界面：

图片插入的界面

按照正常的逻辑，只要我输入 description 或者 title，应该可以直接输出描述或者 Title，虽然我不明白 Ulysses 对描述和 Title 理解的区别，但是在文章里，「简述一幅图片插入的理由」应该是毫无疑问的需求。Ulysses 对这点支持得很不好，比如，插好图片并且填写信息后，在使用 HTML 和 PDF 预览时却产生了这样的差异：

HTML和PDF输出图片描述差异


也就是说 HTML 格式预览可以显示对图片的描述，而 PDF 不可以，这对于学术写作非常不友好，因此找到两种方法解决该问题。

2. HTML 转 PDF

既然 HTML 可以直接输出描述，那么只要将 HTML 直接转换成 PDF 就是曲线救国的思路。因此，如果使用 Mac Ulysses App，那么很简单：

  1. 使用自带 Safari 浏览器（或者任意浏览器）打开 HTML 预览
  2. Safari + 预览，将网页转化为自定义尺寸 PDF | 一日一技
预览演示


如果经常使用 iOS Ulysses App，那么稍微麻烦一点。@Reagan 在 Ulysses 导出带有图片说明的 PDF 文件 | 一日一技 这篇文章里给出一种 Ulysses + iCab Mobile 的实现方式。其实使用 Readdle 家 PDF Expert 或者可能任何类似 App 都可以打开带有图片标题的 HTML。但是，采用 HTML 转 PDF 的问题也很多，比如说图片尺寸不令人满意。

那么能不能直接在 PDF 输出带有图片描述的文章呢？答案是可以的：

直接输出PDF图片描述的对比


左边是没修改之前的状态，右边是修改后的 PDF，实现思路是将图片下第一行文字和图片一样进行居中处理。

3. 直接输出带有图片描述的PDF

在具体修改之前，有必要 Ulysses 的自定义功能。Ulysses 的自定义功能太丰富，导致很多人望而却步，不像 Byword 你也没啥可修改的反而省事，all it depends. Ulysses 有两个地方可以自定义，分别是 Markup 和 Styles，在 preference 里面可以找到。

首先是 Markup 修改界面：

Markup 修改界面

然后是 Styles 修改界面：

Styles 修改界面

就我个人而言，Markup 属于一种对 Markdown 语法的标记修改，更偏向主题或者是皮肤的修改。Styles 则是对整篇文章的布局、字体等的修改，具体可以对应到不同格式的修改，比如 PDF 或者 HTML。有人曾经跟我讨论说怎么选择合适自己的 Style，我想说的是，只能自己试，不满意的地方就该，比如引用风格、引用字体的颜色、图片尺寸，这些在 Ulysses 里面都可以修改，跟 MS Word 稍有不同的是，它藏得比较深。那么我就从图片描述这一点出发，给出修改步骤。

3.1 修改 PDF Style

首先，打开 PDF 目标格式的 .ulss 文件，如果是 Ulysses 自带的文件需要先复制再用 text editor 打开。如果觉得有些复杂，你只需要对自己说，嗨，这就是一个文本文档。从桌面左上角的 Preference 进入找到位于右上角的 Styles，找到目标格式，比如下面的 GitHub_update，右击出现以下界面：

Preference - Styles - Edit in - TextEdit

用系统自带的文本编辑器打开即可，下图是打开后的样子：

编辑界面

将光标移动到 Paragraph Styles，「段落风格」字眼的部分：

Paragraph Styles

另起一行，添加标注的内容 paragraph-figure+paragraph：

添加标注的内容

也就是以下内容：

paragraph-figure + paragraph {
	text-alignment:	center
	first-line-indent:	0pt
	margin-bottom:	2.75pt
	}

这段是将图片下面的第一行进行居中处理，看起来就恰好是图片描述。具体写文档的时候，只需要在每个图片下面添加对应描述，在 PDF 预览中即可实现前面所讲的「带有图片描述的 PDF 文章」。如果想限制图片大小，添加下面这段，修改类似 2.5mm 这样的数据，直到满意为止。


//	Images
//

paragraph-figure {
	margin-top:				2.5mm
	margin-bottom:			2.5mm
	margin-left:			15mm
	margin-right:			15mm
}

4.尾巴

Ulysses 修改格式纷繁杂乱，刚开始不知道从何处下笔，于是从挑选解决我痛点的「PDF 图片描述」开始，从点出发是一个很不错的上手方式。