{"id":51288655,"url":"https://github.com/yakkomajuri/seams","last_synced_at":"2026-06-30T08:32:08.546Z","repository":{"id":351368817,"uuid":"1210493361","full_name":"yakkomajuri/seams","owner":"yakkomajuri","description":"Get a beautiful rich markdown editor from any directory by running `seams .`","archived":false,"fork":false,"pushed_at":"2026-04-21T19:08:14.000Z","size":451,"stargazers_count":2,"open_issues_count":2,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-21T21:15:45.227Z","etag":null,"topics":["block-editor","cli","editor","markdown","markdown-editor","npm"],"latest_commit_sha":null,"homepage":"https://getablog.org","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yakkomajuri.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-14T13:23:09.000Z","updated_at":"2026-04-19T23:53:44.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/yakkomajuri/seams","commit_stats":null,"previous_names":["yakkomajuri/seams"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/yakkomajuri/seams","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yakkomajuri%2Fseams","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yakkomajuri%2Fseams/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yakkomajuri%2Fseams/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yakkomajuri%2Fseams/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yakkomajuri","download_url":"https://codeload.github.com/yakkomajuri/seams/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yakkomajuri%2Fseams/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34959505,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-30T02:00:05.919Z","response_time":92,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["block-editor","cli","editor","markdown","markdown-editor","npm"],"created_at":"2026-06-30T08:32:07.750Z","updated_at":"2026-06-30T08:32:08.528Z","avatar_url":"https://github.com/yakkomajuri.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# seams (beta)\n\n`seams` is a rich Markdown editor that's triggered via CLI and runs on-demand for the directory you choose.\n\nFor example, if you run:\n\n```bash\nseams .\n```\n\n`seams` will start a server running on port `4444` and open a web browser with a rich Markdown editor so you can edit the files in the current directory.\n\n![seams-gif.gif](/assets/seams-gif.gif)\n\n## Installation\n\n```bash\nnpm install -g seams-cli\n```\n\n## Why\n\nI write a lot of Markdown. Blogs, websites, documentation.\n\nMarkdown comes very naturally to me, but editing Markdown in an IDE comes with a few downsides that easily break your writing flow.\n\nFor one, editing Markdown in an IDE means you have a ton of other files lying around that are irrelevant to you. Then there are little annoyances like dealing with images, tables, details tags and so on.\n\n`seams` let's you focus on writing and have all the nice things you'd need from something like Obsidian directly in any directory of your choice. One command and you get a fully-featured editor in any directory.\n\n## Features\n\n**On-demand**\n\nRun `seams .` when you need it and get an editor in a second.\n\n**Image uploads**\n\n`/image` and you can select an image from your device and it will be placed in your designated assets subdirectory.\n\n**Table support**\n\nNo need to deal with Markdown syntax for tables anymore. `/table` and you're done.\n\n**Details blocks**\n\nA lot of Markdown parsers support HTML `\u003cdetails\u003e` tags for collapsible content.\n\nSeams supports this and gives you the interactive collapsible section in the UI.\n\n**Strip away the fluff**\n\nBy default `seams` will hide all directories that don't contain `.txt`, `.md`, and `.mdx` files so you can easily navigate only the documentation or your blog posts.\n\n**Command bar**\n\nEasily switch between files and search content only within your text/Markdown files.\n\n**Code blocks**\n\n`seams` gives syntax highlighted code blocks with a language picker.\n\n**Seamlessly switch between rich and raw**\n\nEdit in Rich or Raw mode according to your preference.\n\n**Smart links**\n\nEasily link between files in the same directory.\n\n**Block editing**\n\nDrag and drop blocks of text and convert between styles.\n\n## Usage\n\n```bash\nUsage:\n  $ seams [dir]\n\nCommands:\n  [dir]  Open a directory in seams\n\nFor more info, run any command with the `--help` flag:\n  $ seams --help\n\nOptions:\n  --port \u003cport\u003e    Port number\n  --no-open        Do not open browser\n  -v, --version    Display version number\n  -h, --help       Display this message\n```\n\n### Configuration\n\n`seams` configuration happens per-directory. Once you open the `seams` editor you can click on the gear icon on the sider to get to the Settings page where you can configure things like theme and assets directory.\n\nChanging any value here will create a `.seamsrc` file in your directory that `seams` will read from going forward.\n\nHere's what a `.seamsrc` config file looks like:\n\n```json\n{\n  \"depth\": 5,\n  \"defaultPort\": 4444,\n  \"assets\": \"./assets\",\n  \"autoSave\": true,\n  \"autoSaveDelay\": 100,\n  \"hideDirsWithoutMd\": true,\n  \"theme\": \"neutral-dark\",\n  \"ignoreDirs\": [\n    \"node_modules\"\n  ],\n  \"ignoreFiles\": [\n    \"drafts/todo.txt\"\n  ],\n  \"linkRoot\": \"/blog\"\n}\n```\n\n**Config options list**\n\n| Option              | Type                                | Default            | Description                                                                             |\n| ------------------- | ----------------------------------- | ------------------ | --------------------------------------------------------------------------------------- |\n| `depth`             | `number`                            | `5`                | Maximum directory depth to scan when building the file tree.                            |\n| `defaultPort`       | `number`                            | `4444`             | Port for the local server. Increments automatically if the port is already in use.      |\n| `assets`            | `string`                            | `\"./assets\"`       | Relative path to the directory where uploaded images and files are stored.              |\n| `autoSave`          | `boolean`                           | `true`             | Automatically save changes to disk after a short delay.                                 |\n| `autoSaveDelay`     | `number` (ms)                       | `100`              | Milliseconds to wait after the last edit before auto-saving. Requires `autoSave: true`. |\n| `hideDirsWithoutMd` | `boolean`                           | `true`             | Hide directories with no Markdown files from the sidebar file tree.                     |\n| `theme`             | `\"neutral-dark\" \\| \"neutral-light\"` | `\"neutral-dark\"`   | Editor UI color theme.                                                                  |\n| `ignoreDirs`        | `string[]`                          | `[\"node_modules\"]` | Directories to exclude from the file tree, search, and file watching.                   |\n| `ignoreFiles`       | `string[]`                          | `[]`               | Files to exclude from the file tree, search, and file watching.                         |\n| `linkRoot`          | `string`                            | —                  | Root path prefix used when generating links between files.                              |\n\n## MDX support\n\n`seams` supports MDX in the sense that it can open MDX files but not render the components (as those are platform-dependent). In that case we create an \"MDX block\" that is basically a code block so you can edit MDX components raw inside `seams`.\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyakkomajuri%2Fseams","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyakkomajuri%2Fseams","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyakkomajuri%2Fseams/lists"}