{"id":50784615,"url":"https://github.com/madebysan/markflow","last_synced_at":"2026-06-12T06:32:31.682Z","repository":{"id":353454542,"uuid":"1214602409","full_name":"madebysan/markflow","owner":"madebysan","description":"Simple on-the-go markdown reader and editor for iOS.","archived":false,"fork":false,"pushed_at":"2026-05-15T20:12:52.000Z","size":22703,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-15T23:13:01.294Z","etag":null,"topics":["ios","ios-app","ios26","markdown","native-app","swift","swiftui","xcodegen"],"latest_commit_sha":null,"homepage":null,"language":"Swift","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/madebysan.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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-18T19:52:40.000Z","updated_at":"2026-05-15T20:12:56.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/madebysan/markflow","commit_stats":null,"previous_names":["madebysan/markflow"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/madebysan/markflow","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/madebysan%2Fmarkflow","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/madebysan%2Fmarkflow/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/madebysan%2Fmarkflow/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/madebysan%2Fmarkflow/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/madebysan","download_url":"https://codeload.github.com/madebysan/markflow/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/madebysan%2Fmarkflow/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34232790,"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-12T02:00:06.859Z","response_time":109,"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":["ios","ios-app","ios26","markdown","native-app","swift","swiftui","xcodegen"],"created_at":"2026-06-12T06:32:29.735Z","updated_at":"2026-06-12T06:32:31.673Z","avatar_url":"https://github.com/madebysan.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp\u003e\u003cimg src=\"docs/icon.png\" width=\"128\" height=\"128\" alt=\"Markflow icon\"\u003e\u003c/p\u003e\n\n\u003ch1\u003eMarkflow\u003c/h1\u003e\n\n\u003cp\u003eSimple on-the-go markdown reader and editor for iOS.\u003c/p\u003e\n\n\u003cp\u003e\u003cstrong\u003eVersion 0.2.0\u003c/strong\u003e · iOS 26 · SwiftUI\u003c/p\u003e\n\n\u003cp\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Swift-f05138\" alt=\"Swift\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/SwiftUI-0066cc\" alt=\"SwiftUI\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/iOS-000000\" alt=\"iOS\"\u003e\n\u003c/p\u003e\n\n\u003cp\u003e\n  \u003ca href=\"https://apps.apple.com/us/app/markflow-markdown-reader/id6763440990\"\u003e\u003cimg src=\"https://developer.apple.com/assets/elements/badges/download-on-the-app-store.svg\" alt=\"Download on the App Store\" height=\"50\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n![Markflow app screenshots](docs/screenshots/hero.png)\n\nMarkflow is a native markdown reader and editor for iOS 26. Tap any `.md` file in Files, Mail, or Safari and it opens rendered: code blocks, mermaid diagrams, tables, inline images. Files open read-only by default and edits live in memory until you explicitly choose Save, Save as New File, or Share.\n\n## How it works\n\nFiles open in read-only mode by default. Tap the floating eye/pencil glass button at the bottom to switch to Edit. Edits live in memory until you Save (writes to source), Save as New File (file picker), Share, or Export as PDF.\n\nA floating Liquid Glass keyboard toolbar covers headings, bold/italic/strikethrough, links, images (PHPicker → saved sibling to your .md), task/bullet/numbered lists, blockquotes, inline code, code blocks, and rules. Pinch-to-zoom works everywhere: WKWebView zoom in Preview, font scaling in Edit. Swipe from the left edge of an open document to dismiss it.\n\nSettings (gear in Home top-right, or in any document's ••• menu) covers:\n\n- **Appearance** — System / Light / Dark\n- **Theme** — 5 curated themes (Indigo, Forest, Sunset, Ocean, Graphite), each with light + dark accents\n- **Text** — 6 fonts (System, Rounded, Charter, Monospace, iA Writer, JetBrains Mono); editor + preview size sliders\n- **Behavior** — pick whether new files open in Edit or Preview\n- **Recents** — last 4 opened files surface on Home; clearable from Settings\n\n## Build from source\n\nRequires Xcode 26 and the iOS 26 simulator runtime.\n\n```bash\ncd Markflow\nxcodegen generate\nxcodebuild -project Markflow.xcodeproj -scheme Markflow \\\n  -destination 'platform=iOS Simulator,name=iPhone 16e' build\n```\n\nOr open in Xcode and press ⌘R:\n\n```bash\nopen Markflow.xcodeproj\n```\n\nFor a physical-device build, the bundle is signed under Team `QAMM2A6WRQ` (Apple Developer Program). Select your iPhone in Xcode's device picker and hit Run.\n\n## Project layout\n\n\u003cdetails\u003e\n\u003csummary\u003eFile tree\u003c/summary\u003e\n\n```\nmd-reader/\n├── Markflow.xcodeproj/         # generated by xcodegen\n├── project.yml                 # xcodegen config\n├── Markflow/\n│   ├── MarkflowApp.swift       # @main, WindowGroup { HomeView() }\n│   ├── Info.plist              # CFBundleDocumentTypes for .md handler\n│   ├── Assets.xcassets/        # AppIcon (1024) + HomeIcon (for in-app display)\n│   ├── Resources/\n│   │   ├── welcome.md          # Template shown on Create\n│   │   ├── preview.html        # HTML template + CSS\n│   │   ├── marked.min.js       # markdown -\u003e HTML (40 KB)\n│   │   ├── highlight.min.js    # syntax highlighting (125 KB)\n│   │   ├── highlight-github.css\n│   │   ├── highlight-github-dark.css\n│   │   └── mermaid.min.js      # flowcharts (3 MB)\n│   └── Views/\n│       ├── HomeView.swift      # gradient home with Browse/Create CTAs\n│       ├── DocumentView.swift  # nav bar with picker + share\n│       ├── EditView.swift      # UITextView + markdown toolbar + pinch font scaling\n│       └── PreviewView.swift   # WKWebView wrapper\n```\n\n\u003c/details\u003e\n\n## Known limitations\n\n- Relative image paths in markdown (`![](image.png)`) don't resolve. Use absolute URLs.\n- No \"Recents\" list on the home screen (dropped when we replaced `DocumentGroup`).\n\n## Support\n\nUser support: see [docs/support.md](docs/support.md) or email [hi@santiagoalonso.com](mailto:hi@santiagoalonso.com).\n\nBug reports and feature requests: [open an issue](https://github.com/madebysan/markflow/issues).\n\n## Acknowledgements\n\nRendering libraries, vendored in `Markflow/Resources/`:\n\n- [marked](https://github.com/markedjs/marked) for markdown parsing\n- [highlight.js](https://github.com/highlightjs/highlight.js) for syntax highlighting\n- [Mermaid](https://github.com/mermaid-js/mermaid) for diagrams and flowcharts\n\nBundled fonts (SIL Open Font License), in `Markflow/Resources/fonts/`:\n\n- [iA Writer Quattro S](https://github.com/iaolo/iA-Fonts) by iA Inc.\n- [JetBrains Mono](https://github.com/JetBrains/JetBrainsMono) by JetBrains\n\n## License\n\n[MIT](LICENSE)\n\n---\n\nMade by [santiagoalonso.com](https://santiagoalonso.com)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmadebysan%2Fmarkflow","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmadebysan%2Fmarkflow","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmadebysan%2Fmarkflow/lists"}