Add --render-markdowns command flag and renderMarkdown spec option

CHANGELOG.md

@@ -8,6 +8,7 @@
 - Config setting presets can now also be loaded from the main bundle when bundling XcodeGenKit #1135 @SofteqDG
 - Added ability to generate multiple projects in one XcodeGen launch #1270 @skofgar
 - Use memoization during recursive SpecFiles creation. This provides a drastic performance boost with lots of recursive includes #1275 @ma-oli
+- Added `--render-markdowns` command flag to generate the `.xcodesamplecode.plist` inside the project container and let Xcode render the markdown files with `md` extension.
 
 ### Fixed
 

Sources/XcodeGenCLI/Commands/GenerateCommand.swift

@@ -22,6 +22,9 @@ class GenerateCommand: ProjectCommand {
 
     @Flag("--only-plists", description: "Generate only plist files")
     var onlyPlists: Bool
+
+    @Flag("--render-markdowns", description: "Render markdown files with `.md` extension")
+    var renderMarkdowns: Bool
 
     init(version: Version) {
         super.init(version: version,
@@ -115,6 +118,16 @@ class GenerateCommand: ProjectCommand {
         } catch {
             throw GenerationError.writingError(error)
         }
+
+        // add markdown renderer if needed
+        if renderMarkdowns {
+            do {
+                try fileWriter.writeMarkdownRendererPlist()
+                success("Xcode markdown rendering enabled")
+            } catch {
+                throw GenerationError.writingError(error)
+            }
+        }
 
         // write cache
         if let cacheFile = cacheFile {

Sources/XcodeGenKit/FileWriter.swift

@@ -40,6 +40,11 @@ public class FileWriter {
             }
         }
     }
+
+    public func writeMarkdownRendererPlist() throws {
+        let path = project.defaultProjectPath + ".xcodesamplecode.plist"
+        try writePlist([:], path: path.string)
+    }
 
     private func writePlist(_ plist: [String: Any], path: String) throws {
         let path = project.basePath + path