我该如何在Xcode中编辑Markdown文件？

Question

我不知道如何在Xcode中编辑Markdown文件。该文件似乎以只读模式呈现。是否有任何设置可以允许我在Xcode中编辑Markdown文件？

我试图向苹果的示例项目README.mdhttps://developer.apple.com/documentation/pencilkit/drawing_with_pencilkit添加注释。

- Legolas Wang

Answer 1

如果您的 .md 文件无法编辑，可能是因为您不在源代码模式下。在项目导航器中右键单击文件（如果左侧面板不可见，请按 Cmd+1），选择“打开方式/源代码”选项。如果您想要在从苹果开发者网站下载的 Xcode 项目中编辑 .md 文件，在打开项目之前，请删除项目文件夹中的这两个文件。

Configuration/SampleCode.xcconfig
[project name].xcodeproj/.xcodesamplecode.plist

以下是如何访问第二个文件的方法：

• 在Finder中右键单击.xcodeproj文件，选择“显示包内容”。
• 如果Finder中未显示隐藏文件，请按下 ⌘⇧. (Cmd+Shift+period)。

- Tamás Sengel

---

谢谢！不幸的是，这仍然没有解决我的问题。我正在尝试向苹果的示例项目的自述文件中添加注释。但是，我仍然无法使用提供的方法进行编辑。我是否遗漏了此项目中的任何设置？https://developer.apple.com/documentation/pencilkit/drawing_with_pencilkit - Legolas Wang

@LegolasWang 我已经添加了一些关于如何使用示例项目的说明。 - Tamás Sengel

谢谢！你的答案完美地解决了我的问题。我曾听说过将.markdown强制转换为渲染模式的.xcodesamplecode.plist。但是以前找不到它。感谢您提供详细的说明。 - Legolas Wang

所以，如果你想看到它被渲染，你必须创建那个.xcodesamplecode.plist文件，如果你想编辑它，你必须移动或删除那个文件？没有办法在不使用该文件来切换两种模式的情况下进行编辑和渲染吗？ - Rob N

由于一切都失败了，我不得不使用外部编辑器打开它 :( 至少那样可以工作。 - Kevin Oswaldo

Answer 2

截至Xcode 13.2.1版本，这个问题仍然存在。以下是一个丑陋的解决方法：

1. 在Project.xcodeproj/目录中创建一个名为.xcodesamplecode.plist的文件，并将以下内容复制到其中：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<array/>
</plist>

2. 第1步会导致Xcode以只读模式呈现markdown格式的README.md。

3. 要编辑markdown，请关闭所有显示README.md的窗口和/或选项卡。

4. 将README.md重命名为任何其他带有.md后缀的名称，例如editable.md。

5. 现在打开editable.md，它将是可编辑的。

6. 编辑完成后，请关闭所有editable.md窗口并将其重新命名为README.md。

7. 向Apple提交错误报告。

- par

Answer 3

针对Xcode 12：

在右侧检查器面板中，将类型更改为：Swift源代码

关闭编辑器

右键单击文件，再次选择“作为源代码打开”

- CodeFarmer