{"action":"created","comment":{"url":"https://api.github.com/repos/PowerShell/PowerShell-RFC/pulls/comments/177907252","pull_request_review_id":107871101,"id":177907252,"diff_hunk":"@@ -0,0 +1,199 @@\n+---\n+RFC: \n+Author: Aditya Patwardhan\n+Status: Draft\n+SupercededBy: \n+Version: 0.3\n+Area: Formatting and Output\n+Comments Due: 03/26/2018\n+Plan to implement: Yes\n+---\n+\n+# Native Markdown Rendering\n+\n+Render markdown content on console to improve readability.\n+\n+## Motivation\n+\n+Markdown is a common authoring format used by the community.\n+There is no easy way in PowerShell to visualize a markdown document on console.\n+\n+## Specification\n+\n+This RFC proposes to use `VT100` escape sequences to render markdown content.\n+`ConvertFrom-Markdown` cmdlet as part of `Microsoft.PowerShell.Utility` PowerShell module would consume a string or a file path and output a PSObject containing three properties, `Tokens`, `Html`, `VT100EncodedString`.\n+The `Tokens` property has the AST for the markdown document from `markdig`.\n+The `Html` property has the markdown document converted to `HTML`.\n+The `VT100EncodedString` property has the markdown documented with `VT100` escape sequences.\n+By default, the `Tokens`and `Html` properties will be populated.\n+The `VT100EncodedString` property will be populated only when `-AsVT100EncodedString` is specified.\n+\n+For converting strings to VT100 coded strings, we will be writing an extension to [markdig](https://github.com/lunet-io/markdig).\n+The extension will insert VT100 escape sequences as appropriate.\n+\n+### Specification for `ConvertFrom-Markdown`\n+\n+```PowerShell\n+\n+ConvertFrom-Markdown [-Path] <string[]> [-AsVT100EncodedString] [<CommonParameters>]\n+\n+ConvertFrom-Markdown [-LiteralPath] <string[]> [-AsVT100EncodedString] [<CommonParameters>]\n+\n+ConvertFrom-Markdown [-InputObject] <psobject> [-AsVT100EncodedString] [<CommonParameters>]\n+\n+```\n+\n+#### Parameters\n+\n+- **Path** : Accepts an array of file paths with markdown content.\n+- **LiteralPath** : Accepts an array of literal paths with markdown content.\n+- **InputObject** : Accepts an InputObject of `System.IO.FileInfo`, `string` type.\n+- **AsVT100EncodedString** : When selected, the `VT100EncodedString` property is populated.\n+\n+There will be support for changing the colors for various elements using the `Set-MarkdownOption` cmdlet. To retrieve the current settings `Get-MarkdownOption` cmdlet can be used.\n+\n+### Specification for `Set-MarkdownOption`\n+\n+```PowerShell\n+\n+Set-MarkdownOption [-Header1Color <ConsoleColor>] [-Header2Color <ConsoleColor>] [-Header3Color <ConsoleColor>] [-Header4Color <ConsoleColor>] [-Header5Color <ConsoleColor>] [-Header6Color <ConsoleColor>] [-CodeBlockForegroundColor <ConsoleColor>] [-CodeBlockBackgroundColor <ConsoleColor>] [-ImageAltTextForegroundColor <ConsoleColor>] [-LinkForegroundColor <ConsoleColor>] [-ItalicsForegroundColor <ConsoleColor>] [<CommonParameters>]\n+\n+Set-MarkdownOption -Theme <string> [<CommonParameters>]\n+\n+Set-MarkdownOption -InputObject <psobject> [<CommonParameters>]\n+\n+```\n+\n+The properties can individually customize the rendering on console.\n+Dark will be the default theme.\n+The individual colors for the dark theme are specified in the subsequent sections.\n+\n+### Specification for `Get-MarkdownOption`\n+\n+```PowerShell\n+\n+Get-MarkdownOption [<CommonParameters>]\n+\n+```\n+\n+### Specification for `Export-MarkdownOption`\n+\n+```PowerShell\n+\n+Export-MarkdownOption -Path <string> [<CommonParameters>]\n+\n+Export-MarkdownOption -LiteralPath <string> [<CommonParameters>]\n+\n+```\n+\n+Export the current markdown settings to a file.","path":"2-Draft-Accepted/RFCNNNN-Native-Markdown-Rendering.md","position":89,"original_position":89,"commit_id":"60bc1cad3cc3c167bf8f32048ea4c9c2c3e1c4ff","original_commit_id":"60bc1cad3cc3c167bf8f32048ea4c9c2c3e1c4ff","user":{"login":"joeyaiello","id":1255187,"avatar_url":"https://avatars0.githubusercontent.com/u/1255187?v=4","gravatar_id":"","url":"https://api.github.com/users/joeyaiello","html_url":"https://github.com/joeyaiello","followers_url":"https://api.github.com/users/joeyaiello/followers","following_url":"https://api.github.com/users/joeyaiello/following{/other_user}","gists_url":"https://api.github.com/users/joeyaiello/gists{/gist_id}","starred_url":"https://api.github.com/users/joeyaiello/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/joeyaiello/subscriptions","organizations_url":"https://api.github.com/users/joeyaiello/orgs","repos_url":"https://api.github.com/users/joeyaiello/repos","events_url":"https://api.github.com/users/joeyaiello/events{/privacy}","received_events_url":"https://api.github.com/users/joeyaiello/received_events","type":"User","site_admin":false},"body":"What kind of file are we exporting/importing the options as? .psd1? ","created_at":"2018-03-28T22:19:19Z","updated_at":"2018-03-28T22:35:11Z","html_url":"https://github.com/PowerShell/PowerShell-RFC/pull/116#discussion_r177907252","pull_request_url":"https://api.github.com/repos/PowerShell/PowerShell-RFC/pulls/116","author_association":"OWNER","_links":{"self":{"href":"https://api.github.com/repos/PowerShell/PowerShell-RFC/pulls/comments/177907252"},"html":{"href":"https://github.com/PowerShell/PowerShell-RFC/pull/116#discussion_r177907252"},"pull_request":{"href":"https://api.github.com/repos/PowerShell/PowerShell-RFC/pulls/116"}}},"pull_request":{"url":"https://api.github.com/repos/PowerShell/PowerShell-RFC/pulls/116","id":173039582,"html_url":"https://github.com/PowerShell/PowerShell-RFC/pull/116","diff_url":"https://github.com/PowerShell/PowerShell-RFC/pull/116.diff","patch_url":"https://github.com/PowerShell/PowerShell-RFC/pull/116.patch","issue_url":"https://api.github.com/repos/PowerShell/PowerShell-RFC/issues/116","number":116,"state":"open","locked":false,"title":"RFC for native markdown parsing on console","user":{"login":"adityapatwardhan","id":12820925,"avatar_url":"https://avatars0.githubusercontent.com/u/12820925?v=4","gravatar_id":"","url":"https://api.github.com/users/adityapatwardhan","html_url":"https://github.com/adityapatwardhan","followers_url":"https://api.github.com/users/adityapatwardhan/followers","following_url":"https://api.github.com/users/adityapatwardhan/following{/other_user}","gists_url":"https://api.github.com/users/adityapatwardhan/gists{/gist_id}","starred_url":"https://api.github.com/users/adityapatwardhan/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/adityapatwardhan/subscriptions","organizations_url":"https://api.github.com/users/adityapatwardhan/orgs","repos_url":"https://api.github.com/users/adityapatwardhan/repos","events_url":"https://api.github.com/users/adityapatwardhan/events{/privacy}","received_events_url":"https://api.github.com/users/adityapatwardhan/received_events","type":"User","site_admin":false},"body":"<!--\r\n\r\nAll new RFCs should:\r\n\r\n* Not have a number - maintainers will assign the number\r\n* Be placed in the Draft folder\r\n\r\nMaintainers will sometimes need to make small edits (for example, set the RFC number).\r\nTo make this easier, we suggest giving maintainers permission to push to your fork,\r\nsee https://github.com/blog/2247-improving-collaboration-with-forks.\r\n\r\nAlso be sure to read https://github.com/PowerShell/PowerShell-RFC/blob/master/RFC0000-RFC-Process.md\r\n\r\n-->\r\n\r\n","created_at":"2018-03-06T02:09:49Z","updated_at":"2018-03-28T22:35:11Z","closed_at":null,"merged_at":null,"merge_commit_sha":"d1a57386c766e6d0112ad2085ac4177b36552d41","assignee":null,"assignees":[],"requested_reviewers":[],"requested_teams":[],"labels":[{"id":483149339,"url":"https://api.github.com/repos/PowerShell/PowerShell-RFC/labels/Review%20-%20Committee","name":"Review - Committee","color":"c5def5","default":false}],"milestone":null,"commits_url":"https://api.github.com/repos/PowerShell/PowerShell-RFC/pulls/116/commits","review_comments_url":"https://api.github.com/repos/PowerShell/PowerShell-RFC/pulls/116/comments","review_comment_url":"https://api.github.com/repos/PowerShell/PowerShell-RFC/pulls/comments{/number}","comments_url":"https://api.github.com/repos/PowerShell/PowerShell-RFC/issues/116/comments","statuses_url":"https://api.github.com/repos/PowerShell/PowerShell-RFC/statuses/60bc1cad3cc3c167bf8f32048ea4c9c2c3e1c4ff","head":{"label":"adityapatwardhan:MDRendering","ref":"MDRendering","sha":"60bc1cad3cc3c167bf8f32048ea4c9c2c3e1c4ff","user":{"login":"adityapatwardhan","id":12820925,"avatar_url":"https://avatars0.githubusercontent.com/u/12820925?v=4","gravatar_id":"","url":"https://api.github.com/users/adityapatwardhan","html_url":"https://github.com/adityapatwardhan","followers_url":"https://api.github.com/users/adityapatwardhan/followers","following_url":"https://api.github.com/users/adityapatwardhan/following{/other_user}","gists_url":"https://api.github.com/users/adityapatwardhan/gists{/gist_id}","starred_url":"https://api.github.com/users/adityapatwardhan/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/adityapatwardhan/subscriptions","organizations_url":"https://api.github.com/users/adityapatwardhan/orgs","repos_url":"https://api.github.com/users/adityapatwardhan/repos","events_url":"https://api.github.com/users/adityapatwardhan/events{/privacy}","received_events_url":"https://api.github.com/users/adityapatwardhan/received_events","type":"User","site_admin":false},"repo":{"id":65857140,"name":"PowerShell-RFC","full_name":"adityapatwardhan/PowerShell-RFC","owner":{"login":"adityapatwardhan","id":12820925,"avatar_url":"https://avatars0.githubusercontent.com/u/12820925?v=4","gravatar_id":"","url":"https://api.github.com/users/adityapatwardhan","html_url":"https://github.com/adityapatwardhan","followers_url":"https://api.github.com/users/adityapatwardhan/followers","following_url":"https://api.github.com/users/adityapatwardhan/following{/other_user}","gists_url":"https://api.github.com/users/adityapatwardhan/gists{/gist_id}","starred_url":"https://api.github.com/users/adityapatwardhan/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/adityapatwardhan/subscriptions","organizations_url":"https://api.github.com/users/adityapatwardhan/orgs","repos_url":"https://api.github.com/users/adityapatwardhan/repos","events_url":"https://api.github.com/users/adityapatwardhan/events{/privacy}","received_events_url":"https://api.github.com/users/adityapatwardhan/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/adityapatwardhan/PowerShell-RFC","description":"RFC documents for community feedback on design changes and improvements to PowerShell","fork":true,"url":"https://api.github.com/repos/adityapatwardhan/PowerShell-RFC","forks_url":"https://api.github.com/repos/adityapatwardhan/PowerShell-RFC/forks","keys_url":"https://api.github.com/repos/adityapatwardhan/PowerShell-RFC/keys{/key_id}","collaborators_url":"https://api.github.com/repos/adityapatwardhan/PowerShell-RFC/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/adityapatwardhan/PowerShell-RFC/teams","hooks_url":"https://api.github.com/repos/adityapatwardhan/PowerShell-RFC/hooks","issue_events_url":"https://api.github.com/repos/adityapatwardhan/PowerShell-RFC/issues/events{/number}","events_url":"https://api.github.com/repos/adityapatwardhan/PowerShell-RFC/events","assignees_url":"https://api.github.com/repos/adityapatwardhan/PowerShell-RFC/assignees{/user}","branches_url":"https://api.github.com/repos/adityapatwardhan/PowerShell-RFC/branches{/branch}","tags_url":"https://api.github.com/repos/adityapatwardhan/PowerShell-RFC/tags","blobs_url":"https://api.github.com/repos/adityapatwardhan/PowerShell-RFC/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/adityapatwardhan/PowerShell-RFC/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/adityapatwardhan/PowerShell-RFC/git/refs{/sha}","trees_url":"https://api.github.com/repos/adityapatwardhan/PowerShell-RFC/git/trees{/sha}","statuses_url":"https://api.github.com/repos/adityapatwardhan/PowerShell-RFC/statuses/{sha}","languages_url":"https://api.github.com/repos/adityapatwardhan/PowerShell-RFC/languages","stargazers_url":"https://api.github.com/repos/adityapatwardhan/PowerShell-RFC/stargazers","contributors_url":"https://api.github.com/repos/adityapatwardhan/PowerShell-RFC/contributors","subscribers_url":"https://api.github.com/repos/adityapatwardhan/PowerShell-RFC/subscribers","subscription_url":"https://api.github.com/repos/adityapatwardhan/PowerShell-RFC/subscription","commits_url":"https://api.github.com/repos/adityapatwardhan/PowerShell-RFC/commits{/sha}","git_commits_url":"https://api.github.com/repos/adityapatwardhan/PowerShell-RFC/git/commits{/sha}","comments_url":"https://api.github.com/repos/adityapatwardhan/PowerShell-RFC/comments{/number}","issue_comment_url":"https://api.github.com/repos/adityapatwardhan/PowerShell-RFC/issues/comments{/number}","contents_url":"https://api.github.com/repos/adityapatwardhan/PowerShell-RFC/contents/{+path}","compare_url":"https://api.github.com/repos/adityapatwardhan/PowerShell-RFC/compare/{base}...{head}","merges_url":"https://api.github.com/repos/adityapatwardhan/PowerShell-RFC/merges","archive_url":"https://api.github.com/repos/adityapatwardhan/PowerShell-RFC/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/adityapatwardhan/PowerShell-RFC/downloads","issues_url":"https://api.github.com/repos/adityapatwardhan/PowerShell-RFC/issues{/number}","pulls_url":"https://api.github.com/repos/adityapatwardhan/PowerShell-RFC/pulls{/number}","milestones_url":"https://api.github.com/repos/adityapatwardhan/PowerShell-RFC/milestones{/number}","notifications_url":"https://api.github.com/repos/adityapatwardhan/PowerShell-RFC/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/adityapatwardhan/PowerShell-RFC/labels{/name}","releases_url":"https://api.github.com/repos/adityapatwardhan/PowerShell-RFC/releases{/id}","deployments_url":"https://api.github.com/repos/adityapatwardhan/PowerShell-RFC/deployments","created_at":"2016-08-16T22:13:41Z","updated_at":"2016-06-19T20:08:36Z","pushed_at":"2018-03-20T21:54:08Z","git_url":"git://github.com/adityapatwardhan/PowerShell-RFC.git","ssh_url":"git@github.com:adityapatwardhan/PowerShell-RFC.git","clone_url":"https://github.com/adityapatwardhan/PowerShell-RFC.git","svn_url":"https://github.com/adityapatwardhan/PowerShell-RFC","homepage":"","size":291,"stargazers_count":0,"watchers_count":0,"language":null,"has_issues":false,"has_projects":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":0,"mirror_url":null,"archived":false,"open_issues_count":0,"license":{"key":"mit","name":"MIT License","spdx_id":"MIT","url":"https://api.github.com/licenses/mit"},"forks":0,"open_issues":0,"watchers":0,"default_branch":"master"}},"base":{"label":"PowerShell:master","ref":"master","sha":"a2b6fc606f75885210940eed9501c094edcf716c","user":{"login":"PowerShell","id":11524380,"avatar_url":"https://avatars3.githubusercontent.com/u/11524380?v=4","gravatar_id":"","url":"https://api.github.com/users/PowerShell","html_url":"https://github.com/PowerShell","followers_url":"https://api.github.com/users/PowerShell/followers","following_url":"https://api.github.com/users/PowerShell/following{/other_user}","gists_url":"https://api.github.com/users/PowerShell/gists{/gist_id}","starred_url":"https://api.github.com/users/PowerShell/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/PowerShell/subscriptions","organizations_url":"https://api.github.com/users/PowerShell/orgs","repos_url":"https://api.github.com/users/PowerShell/repos","events_url":"https://api.github.com/users/PowerShell/events{/privacy}","received_events_url":"https://api.github.com/users/PowerShell/received_events","type":"Organization","site_admin":false},"repo":{"id":39794651,"name":"PowerShell-RFC","full_name":"PowerShell/PowerShell-RFC","owner":{"login":"PowerShell","id":11524380,"avatar_url":"https://avatars3.githubusercontent.com/u/11524380?v=4","gravatar_id":"","url":"https://api.github.com/users/PowerShell","html_url":"https://github.com/PowerShell","followers_url":"https://api.github.com/users/PowerShell/followers","following_url":"https://api.github.com/users/PowerShell/following{/other_user}","gists_url":"https://api.github.com/users/PowerShell/gists{/gist_id}","starred_url":"https://api.github.com/users/PowerShell/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/PowerShell/subscriptions","organizations_url":"https://api.github.com/users/PowerShell/orgs","repos_url":"https://api.github.com/users/PowerShell/repos","events_url":"https://api.github.com/users/PowerShell/events{/privacy}","received_events_url":"https://api.github.com/users/PowerShell/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/PowerShell/PowerShell-RFC","description":"RFC documents for community feedback on design changes and improvements to PowerShell","fork":false,"url":"https://api.github.com/repos/PowerShell/PowerShell-RFC","forks_url":"https://api.github.com/repos/PowerShell/PowerShell-RFC/forks","keys_url":"https://api.github.com/repos/PowerShell/PowerShell-RFC/keys{/key_id}","collaborators_url":"https://api.github.com/repos/PowerShell/PowerShell-RFC/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/PowerShell/PowerShell-RFC/teams","hooks_url":"https://api.github.com/repos/PowerShell/PowerShell-RFC/hooks","issue_events_url":"https://api.github.com/repos/PowerShell/PowerShell-RFC/issues/events{/number}","events_url":"https://api.github.com/repos/PowerShell/PowerShell-RFC/events","assignees_url":"https://api.github.com/repos/PowerShell/PowerShell-RFC/assignees{/user}","branches_url":"https://api.github.com/repos/PowerShell/PowerShell-RFC/branches{/branch}","tags_url":"https://api.github.com/repos/PowerShell/PowerShell-RFC/tags","blobs_url":"https://api.github.com/repos/PowerShell/PowerShell-RFC/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/PowerShell/PowerShell-RFC/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/PowerShell/PowerShell-RFC/git/refs{/sha}","trees_url":"https://api.github.com/repos/PowerShell/PowerShell-RFC/git/trees{/sha}","statuses_url":"https://api.github.com/repos/PowerShell/PowerShell-RFC/statuses/{sha}","languages_url":"https://api.github.com/repos/PowerShell/PowerShell-RFC/languages","stargazers_url":"https://api.github.com/repos/PowerShell/PowerShell-RFC/stargazers","contributors_url":"https://api.github.com/repos/PowerShell/PowerShell-RFC/contributors","subscribers_url":"https://api.github.com/repos/PowerShell/PowerShell-RFC/subscribers","subscription_url":"https://api.github.com/repos/PowerShell/PowerShell-RFC/subscription","commits_url":"https://api.github.com/repos/PowerShell/PowerShell-RFC/commits{/sha}","git_commits_url":"https://api.github.com/repos/PowerShell/PowerShell-RFC/git/commits{/sha}","comments_url":"https://api.github.com/repos/PowerShell/PowerShell-RFC/comments{/number}","issue_comment_url":"https://api.github.com/repos/PowerShell/PowerShell-RFC/issues/comments{/number}","contents_url":"https://api.github.com/repos/PowerShell/PowerShell-RFC/contents/{+path}","compare_url":"https://api.github.com/repos/PowerShell/PowerShell-RFC/compare/{base}...{head}","merges_url":"https://api.github.com/repos/PowerShell/PowerShell-RFC/merges","archive_url":"https://api.github.com/repos/PowerShell/PowerShell-RFC/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/PowerShell/PowerShell-RFC/downloads","issues_url":"https://api.github.com/repos/PowerShell/PowerShell-RFC/issues{/number}","pulls_url":"https://api.github.com/repos/PowerShell/PowerShell-RFC/pulls{/number}","milestones_url":"https://api.github.com/repos/PowerShell/PowerShell-RFC/milestones{/number}","notifications_url":"https://api.github.com/repos/PowerShell/PowerShell-RFC/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/PowerShell/PowerShell-RFC/labels{/name}","releases_url":"https://api.github.com/repos/PowerShell/PowerShell-RFC/releases{/id}","deployments_url":"https://api.github.com/repos/PowerShell/PowerShell-RFC/deployments","created_at":"2015-07-27T19:52:09Z","updated_at":"2018-03-22T17:16:20Z","pushed_at":"2018-03-26T18:48:20Z","git_url":"git://github.com/PowerShell/PowerShell-RFC.git","ssh_url":"git@github.com:PowerShell/PowerShell-RFC.git","clone_url":"https://github.com/PowerShell/PowerShell-RFC.git","svn_url":"https://github.com/PowerShell/PowerShell-RFC","homepage":"","size":270,"stargazers_count":105,"watchers_count":105,"language":null,"has_issues":true,"has_projects":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":57,"mirror_url":null,"archived":false,"open_issues_count":36,"license":{"key":"mit","name":"MIT License","spdx_id":"MIT","url":"https://api.github.com/licenses/mit"},"forks":57,"open_issues":36,"watchers":105,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/PowerShell/PowerShell-RFC/pulls/116"},"html":{"href":"https://github.com/PowerShell/PowerShell-RFC/pull/116"},"issue":{"href":"https://api.github.com/repos/PowerShell/PowerShell-RFC/issues/116"},"comments":{"href":"https://api.github.com/repos/PowerShell/PowerShell-RFC/issues/116/comments"},"review_comments":{"href":"https://api.github.com/repos/PowerShell/PowerShell-RFC/pulls/116/comments"},"review_comment":{"href":"https://api.github.com/repos/PowerShell/PowerShell-RFC/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/PowerShell/PowerShell-RFC/pulls/116/commits"},"statuses":{"href":"https://api.github.com/repos/PowerShell/PowerShell-RFC/statuses/60bc1cad3cc3c167bf8f32048ea4c9c2c3e1c4ff"}},"author_association":"MEMBER"}}
{"actor":{"display_login":"joeyaiello"}}